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EDITORIAL 


The Archimedes Magazine 
and Support Group. 



As I expect you will know by now. we have moved offices within St Albans. The new 
premises are much larger, giving us more showroom area, and a larger custom-built j 
area for mail order, and there is easier parking for customers. The move will allow us 
to carry greater quantities of stock items, and to process orders just that little bit 
quicker. Of oourse, some of you may have already come to see us on our open day by 
the time that you read this. 

This issue is the last of volume 2 of RISC User, and we will as usual be including 
with next month's magazine an index to volume 2. We are taking a careful look at 
the responses to our questionnaire, and hope to reflect these during the course of 
volume 3. 

’ j 

To coincide with the new volume we are launching ArcScan II, an upgraded version of 
our indexing software. This allows keyword searching on RISC User and BEEBUG 
magazine items, but now includes the indexes to Acorn’s Archimedes manuals - 
including the new Programmer’s Reference Manual. Additionally ArcScan II is now 
user-customisable, so that it is an easy matter to include your own data files for other 
magazines, or for almost any other purpose. 

As of next month, David Spencer, our Technical Editor, is vacating his seat in the 
office to concentrate more fully on hardware projects within the company, though he 
will still be contributing to the magazine on a part-time basis. The post of Technical 
Editor thus falls vacant, and is advertised elsewhere in this issue. 

Finally, Acorn have asked us to appeal for notification of any errors which you spot in 
their new manuals (this includes the RISC OS User Guide, Basic Guide and 
Programmer's Reference Manual). Please send them to our editorial address, marking 
the envelope "Acorn Manual Errors’, and we will pass them on. 

Readers may wish to know that we have cancelled Mach Technology's advertising for this issue, • 
as they have been unable to meet their commitments to us in this respect. 



\ 


\ ^ 







NEW C COMPILER ON ITS WAY 

Acorn is shortly to release the third version of the 
Archimedes 0 compiler. This new version is a major 
leap forward from the previous release, and now 
Includes a wealth of library functions to allow the use 
of RISC OS features. For example, library calls exist 
to allow the direct interpretation of Draw files, and all 
Wimp operations are catered for The new compiler 
now uses the RISC OS shared C library by default, 
and also supports code overlays to allow programs 
that are larger than the available memory to be used. 
The system is supplied on three discs, which as well 
as the compiler and a new Sinker, include many 
examples, the symbolic debugger and make utility 
previously found on the Software Developer's Toolbox, 
and Form Ed. This latter is an application to edit Wimp 
template files, and Is vital to anyone writing a major 
application. 

The documentation has also been enhanced, and 
now consists of a manual running to over 500 pages. 
Unlike with previous releases, ail the library functions are 
documented, but the manual does not attempt to be a 
tutorial guide. The new compiler will cost £171.35 (inc. 
VAT) and will be available from mid-October. 

A FRONT FOR C 

Also for C enthusiasts, Mitre Software has released 
a new product called C-Front, an enhanced Desktop 
environment to aid the development of projects using 
Acorn s ANSI C compiler under RISC OS. Both release 
1 and release 2 of Acorn s C are supported, but no 
announcement has yet been made about release 3 (see 
above). C-Front contains four RISC OS applications: 
IC’FRONT which provides an improved interface 
between the Desktop and C, MITMAKE a macro facility 
for compiling and linking multi-file programs, 
IST1CKY8D which allows icons for files, directories and 
applications to be ‘stuck 1 anywhere on the Desktop 
background (similar to the bonus item available to RISC 
User readers on last month's magazine disc), and 
ISETTYPE for changing file types using a RISC OS 
menu. C-Front costs £19.95 inc, VAT from Mitre 
Software Ltd, International House, 26 Creechurch Lane, 
London EC3A 5BA, tel. 01-283 5614. 


ACORN EXTRAS AND UPGRADES 

Acorn are set to release a RISC OS Extras Disc which will 
contain, among other items, a new range of printer drivers 
(including ones for the HP Laserjet and Integrex 
Cotourjet), and various new and replacement modules to 
improve the performance of the Econet system and to 
cure a few minor bugs. Also to be launched is a fonts disc 
containing the new Outline Font Manager and the Trinity, 
Homerton and Corpus fonts. Further font discs will follow, 
and in the future Acorn plan that users should buy fonts 
separately, rather than them being supplied with 
application. The first font disc will cost around £50, 

Acorn are also producing an upgrade to allow the new 
MEMC1A chip (as used in the 400/1 series) to be fitted to 
existing 310 and 440 machines. This will not only give a 
speed increase of about 10%, but will also be essential if 
the new SCSI or Floating Point podules are to be used. 

ARCHIMEDES GETS NETTED 

Specialist software house Software Solutions has 
announced three Econet products for the Archimedes. 
The Disc Sharer allows the hard disc of any networked 
Archimedes to share access with up to 32 other network 
users. As D/sc Sharer is a multi-tasking RISC OS 
application, the shared access Archimedes can continue 
to be used as a single user machine at the same time. 
Shared users have access only to designated directory 
structures on the hard disc, thus protecting all other areas 
of the shared hard disc. It is also possible to run Disc 
Sharer on more than one hard disc Archimedes in an 
Econet network. 

The second network product is a Printer Spooler 
which allows a printer connected to one Archimedes in a 
network to be accessed transparently by any other 
computer in the network. Files for printing are accepted 
immediately, being saved temporarily in a queue pending 
final printing. Again, Printer Spooler is multi-tasking, 
freeing the host machine for other applications. 

The final network product is Remote Logon which 
allows a user to have full password-protected access to 
the hard or floppy disc of his Archimedes from any other 
system on the network. One suggested application 
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involves using Remote Logon to allow a BBC micro to 
be attached to an Archimedes and use its disc storage 
and any printer as though it were its own. 

Disc Sharer and Printer Spooler are sold only as 
network licences; Remote Logon is sold as a single user 
product, though site licences are available on request. 
Prices to education are (ex, VAT) are £110.00 for the disc 
sharer, £65.00 for the printer spooler, and £30.40 for the 
remote logon utility. Prices to other users are 25% higher. 
For more information contact Software Solutions at 
Broadway House, 149-151 St Neots Road, Hardwick, 
Cambridge CB3 70J, or tel. (0954) 211760. 

A3000 HEADS FOR DIXONS 

Acorn's recently launched A3QQ0 is headed for even 
more success in a new deal with Dixons, From September, 
the A3000 will be sold in Dixons’ twenty flagship shops in 
major towns and cities throughout Britain, Acorn sees the 
agreement with the UK’s number one computer retailer as 
an important addition to its existing dealer and distribution 
network. This marks a further stage in the rising success of 
Acorn's new machine. 

EXPANDING THE ACORN R14G UNIX 
WORKSTATION 

The Hugh Symons Group has introduced a series of 
high performance peripherals to further extend the R140 
Archimedes based UNIX system. The new units comprise 
158 Mbyte and 327 Mbyte Winchester disc drives, with 
respective access times of 1$ms and 18ms, a 150 Mbyte 
capacity tape streamer operating at 90 inches per 
second, and a 19-inch high resolution monochrome 
monitor. This gives 1152 by 900 pixels on screen and has 
a video bandwidth of more than 110 MHz. Known as the 
Viking 11, this has been specially developed in the USA by 
Taxan for workstation users, and complements the 
existing Taxan Multlvision colour monitor available for the 
R140. It can also be used with the Archimedes 400 
series, but no prices have been given as yet. 

In addition, Hugh Symons will shortly be releasing a 
four-port RS232 expansion card, developed in conjunction 
with Acorn. This will turn the R140 into a six-user machine, 
and will allow users to exploit already ported multi-user 
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software including Uniplex, Quadraton's Q-Office and 
Informix. An unlimited UNIX user licence has been made 
available with this four-port expansion card. 

For more details and prices on all these products 
contact Hugh Symons Group Pic, 223-227 Aider Road, 
Poole, Dorset BH124AP, oriel. (0202) 740853, 

NEW PRODUCTS FROM CLARES 

Clares Micro Supplies, a strong supporter of the 
Archimedes range, has many new or revamped products 
to be released this Autumn. Available now is Interdictory 
high quality flight simulator costing £34.95 and expected 
to be a top seller in the run up to Christmas, To go with 
Interdictor, Clares has also released the Voltmace Delta- 
Cat joystick at £29.95 which is claimed to provide much 
more realistic control than the standard Archimedes 
mouse. All prices include VAT. 

A second edition of Artisan, referred to simply as 
Artisan 2, will be out very soon. While retaining the mode 
12 of the original, many additional features have been 
added particularly with educational use in mind. It is, of 
course, now fully multi-tasking under RISC OS, For 
education, the software can now be configured to tailor 
the choice of facilities to the skills of the user, and there 
are many extra functions aimed at helping in textile 
design. Artisan 2 costs £59.95, or existing registered 
users of Artisan can upgrade for £30,00. 

Other new products due out later this autumn include 
Knowledge Organiser, a free-form database system which 
includes Z88 compatibility and the facility to input text and 
data from Prestel £59.95), and a Primary Word processor 
with large fonts aimed at primary school children which 
has been developed in conjunction with the Derbyshire 
Education Authority. This will retail at £39,95. 

Finally, Dave Clare reports that good progress is being 
made with Tempest, Clares' DTP package which is 
expected to be released this autumn. Unlike Acorn DTP 
(reviewed RISC User Volume 2 Issue 9) this also includes 
a spelling checker and many additional features all for 
£129.95. Clares are at 98 Middlewich Road, Rudheath, 
Northwich, Cheshire CW9 7DA, or tel. (0606) 48511. gg 
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PRICES 

A3 000 
A410/1 
A420/1 


GUARANTEE 

As a BEEBUG customer you can rely on 
our guarantee of unbeatable service and 
support. 


NATIONWIDE COVERAGE 

Beebug are using CRAY ELECTRONICS PLCto provide the 
maintenance cover which is available throughout the whole 
of mainland UK. Simply make one phone call and an engineer 
wilt call. There is no limit to the number of call-outs that you 
can make over the year. 


Archimedes Magazine - RISC User 


RISC User is ihe Spacing magazine dedicated solely Id ihe Archimedes and 
A3D00 Fch £14.50 a year (UK), you wilt recerve (his 56 page magazine packed 
full of useful mlwmaEion, news, reviews, programs Hints and tips etc marled 
directly to your home 10 limes a year 


Ordering 


Alt items are currently m stock. Prices arc exclusive of VAT please add 15 %. Wte 
accept payment by cash, cheque, Visa. Access, Conned etc as well as official 
orders You may order by phone, fax Of letter Alternatively please phone tor more 
mtormafion. 


ALL ARCHIMEDES & A3000 


This service is included on all new A30GG. A410, A42Q and 
A44Q/1 systems sold by Beebug from September 10th 1989. 
It also covers the Acorn monitor If sold at the same time. 


BASE COLOUR 

649. DO 869 00 

1199.00 1419 00 


117 Hatfield 

Tel: 0727 40303 " *£?"*’ HertS AL1 4J S- 

J Fax: 072760263 


with all 


COMPLETE CONFIDENCE 

Quite simply this means that it your Archimedes goes wrong 
within the first year, an engineer wit! call at your premises 
within 24 hours to repair It. tf it cannot be repaired, a 
replacement wilt normally be left. 


As a licensed credit broker. Beebug 
can offer you 0% finance over 9 
months or 13 75% list rate (typical 
APR 29% f over 12.24 or 36 months. 
Please phone to check Ehe members 
special offers wrth 0% finance 


Untike many dealers we don't lose 
interest as soon as you have made 
your purchase You can afways 
telephone our Technical Supped 
Department or Showroom icy some 
Inendly and impartial advice. 


in add-EtJori to On-Silo Maintenance, if 
you sub&errfre to BEEBUG or RISC 
Usee [or take our a new subscription} 
and purchase an Aram A3000 we will 
also supply: Fish. Pacmania, prinlof 
Lead. 10 a 3.5' D^scs and Lockable 
Disc Box, With an Arcttmadea 
purchase you Can choose 1R£f 
goods to the values shown below. 

Colour Syiton EftirjSyiWn 
JMr&'i cm CUP 

AizPn tru del 


Speedy Service 

Wfe have a new Showroom in Si Albans 
where you can see and try any of ihe 
sysiems They are always on display 
and m slock. Our Mail Order Service is 
also very efficient, with over 80% o! 
orders going out Ihe same day 46 hour 
fully insured delivery charges on 
comptele sysiem are jusl £700 and 24 
hour delivery £11.50 


qtj Gsa t 

0% Finance Technical Support 


3000’s and 
Archimedes 

FROM BEEBUG 

the Archimedes Specialists 











A COLOUR IMAGE PROCESSOR 


AcorrVs Roger Wilson presents a powerful program for manipulating screen 
images, while maintaining maximum definition. 


Because of its length, this program is included 
on the magazine disc only. 


RISC User Volume 2 Issue 6 contained a 
program to convert a screen from one mode 
to another. However, this program was 
relatively simple, and only really worked 
when changing to a mode with at least as 
high a resolution and number of colours. The 
program described here, called ChangeFSt 
(explained later), is much more intelligent, 
and will do its best to retain as much 
information about the image and its colours 
as possible. There are a number of cases 
when such a program can be useful: 

1, Simply displaying an image In different 
screen modes on the Archimedes, where the 
pixels have different aspect ratios or there 
are different numbers of bits per pixel. And, 
indeed, even when there are more bits per 
pixel, on the Archimedes going from 4 bits 
per pixel to 8 bits per pixel involves a 
complete change in the way colour is 
represented. 

2. Moving an image from one computer to 
another, in this case to the Archimedes. 

3. Printing out an image. 

4, Changing the size of an image. 

The modules SpriteExtend (in the ROM) 
and ColourTrans (in the ISystem directory) in 
RISC OS do provide some capabilities for 
displaying pictures In different screen 
modes. ColourTrans can look at the palette 
which a sprite uses and return a list of the 
equivalent closest colours in the current 
screen mode, SpriteExtend can paint sprites 
using the list of equivalent colours, and can 
change the size of the image into the 
bargain, Indeed, it is these two modules that 
were used by the earlier screen converter. 
However, these facilities are rather simplistic: 
ColourTrans makes no effort to use dithering 
(the practice of putting patterns of different 
coloured pixels together to represent other 
j colours) and SpriteExtend simply discards 
additional information if reducing the picture 
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in size (and together they make no attempt 
to enhance the picture when making it 
larger). The reason for these shortcomings is 
quite simple: speed. The algorithm used in 
the program described here uses 105 ARM 
instructions per pixel - and thafs apart from 
any instructions used to read the image in, 
change its size and write the result out. 
Processing a mode 15 picture thus takes 
several seconds, making it impractical for 
use in a real-time desktop environment. 



Before explaining how to use ChangeFSt 
we will look at how it improves the situation, 
and why it takes so iongl One can 
immediately draw up some desirable 
properties for any solution to the image 
changing problem: 

1, Maximising the volume of the colour cube. 
Colour represented in the Red, Green and 
Blue computer graphics system can be 
thought of as a point in a 3D cube whose axes 
are the red T green and blue values. Whatever 
clever approximations, dithering or error 
diffusion techniques are used, the colour 
volume spanned by the r. g and b axes in the 
target should be large enough to contain the 
source volume. If not, then the picture will 
appear faded in some way compared to the 
original ("the red doesn't seem quite the 
same"). For a single picture a colour volume 
only as large as the Input could be chosen; 
alternatively for an arbitrary set of input 
pictures, the colour volume on the output 
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system has to be made as large as possible. 
Where animation is required the colour volume 
has to be consistent for all the pictures. When 
generating the largest volume, it Is important 
to use the system hardware to the limit: for 
example, if one has two bits of control over the 
Archimedes 4 bit D to A converters, the largest 
range is covered by values 0, 5, 10 and 15 
(rather than 0, 4, 8 and 12). 

2. Giving hue consistency at different 
saturations. For example, with a palette with 
different numbers of bits of r. g and b it may 
be impossible to have a consistent set of 
colours representing derived colours at 
different levels of intensity. Shades of white 
and secondary colours (cyan, magenta and 
yellow) are particularly difficult. 

3. Working with the multi-tasking Desktop, 
Acorn are very keen for all new applications 
to be written to work within the Desktop 
environment. This constrains the choice of 
available colours to those set up using the 
Palette Manager. 

The Desktop (default) palette in the 256 
colour modes (e.g. modes 13, I5 f 21 T 24 and 
28) is quite well designed. It does have the 
properties of 1 and 2 (it even has 16 shades 
of grey) and automatically satisfies 3. It Is 
used by many Acorn programs (Draw, Paint) 
and by external programs (Euclid, 
Pro Artisan, Atelier, etc.) to great effect and is 
a safe choice for ChangeFSI, 

With the 16 colour modes (e.g. modes 9 t 
12. 16. 20 and 27) the default palette does 
not satisfy 1 and 2 unless the output is 
purely shades of grey. ChangeFSI has two 
alternatives for colour representation in 16 
colour modes: 

1) use 1 bit of red, 2 bits of green and 1 
bit of blue. This uses up ail the available bits 
and spans the colour cube, but it doesn't 
have full hue consistency and it can't be 
displayed on the Desktop (via CoiourTrans 
and SpriteExtend) without using a 256 colour 
mode (which would allow the use of 256 
colour images anyway!). Extra Information is 
usually put into green since the human eye 
is most sensitive to green light. This option is 
selected by a “c" suffix to the mode 
argument (see later). 


2) use 1 bit of red, 1 bit of green and 1 bit of 
blue. This spans the colour cube and is hue 
consistent, but doesn't use the full range of bits 
provided in the format. CoiourTrans can map 
this to the Desktop with the standard palette wifo 
fair success, except for the lack of magenta (full 
red+fufl blue) in the palette, A better result can 
be achieved by setting six of the colours in the 
palette to red, green, yellow, blue, magenta and 
cyan. Since CoiourTrans will map the colours 
anyway, it doesn't matter which six. but the most 
consistent values are 8=blue, 9-yellow, 
10=green, 11=red, 13-cyan, 14=magenta 
(leaving 0-7, 12 and 15 unchanged). The file 
'RGBColPal' on the disc contains a palette like 
this (plus my own preferred mouse pointer 
colours). This option is selected by a “d M (digital 
RGB) suffix to the mode argument. 



With the 4 colour modes (e.g. modes 8, 
11, 19 and 26) ChangeFSI is really pushed. 
Shades of grey output is done with the 0. 5, 
10. 15 level palette. But how can colour be 
done? For example, each pixel can display 
only one of (say) black, red, green or blue. 
This fails to span the colour cube (it does 
only half of it), however, so black, cyan, 
magenta and yellow are used instead. The 
rest has to be left to luck: there Is no way it 
can approximate to pure shades of red, 
green or blue. Four bit colour pictures can be 
seen on the Desktop In 16 colour modes with 
the above palette or in 256 colour modes. 
This option is also selected by a "c" suffix. 

With 2 colour modes (e.g. modes 0, 18. 23 
and 25) pixels are either ON or OFF. 
ChangeFSI will only do shades of grey output. 
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So that's the canvas ChangeFSI has to 
work on. How does it display the input 
range of colours on these outputs? The 
answer is, as stated above, dithering: the 
process of approximating intensity 
variations with patterned areas. There are 
two basic types of dithering technique: that 
used to print colour magazines and 
newspaper photographs “clustered dot 
dither”, in which the size of the dot is 
changed according to the desired intensity; 
and that used on dot matrix displays, for 
example the grey level patterns used by 1 
bit per pixel mode on the Desktop, 
“dispersed dot dither", where the average 
number of dots in the area gives the 
intensity. Since ChangeFSI's output is to 
raster devices it uses a dispersed dot 
dither. An approximation to a colour will 
produce an error (which might possibly be 
zero if ChangeFSI is very lucky). 
ChangeFSI tracks these errors and ensures 
that over wide areas there is no overall 
error using a technique called “error 
diffusion”, first devised by R.W. Floyd and 
L. Steinberg in 1975. In this technique the 
approximation is made and the error is 
distributed to nearby pixels in the ratios 
shown in figure 1. 



. current pixel - 
r 1 \ 

7/16 of error 

0 

3/16 of error 

t 

5/16 of error 

1/16 of error 


Figure 1. Six pixels showing how the error 
is distributed 


Obviously this assumes that the output is 
being generated row by row left to right and 
top to bottom. The ‘error’ pixels would be 
reflected for other directions. 

ChangeFSI gets some of its name from 
Floyd and Steinberg. Additionally, ChangeFSI 
scans through the picture in a serpentine 
fashion, doing a row of pixels left to right 
followed by the next row right to left. This 
reduces the probability of regular patterns 
which the eye is sensitive to. The final I of the 
name is for Integer: ChangeFSI does all its 
work in 32 bit fixed point integer arithmetic (with 
the point at bit 28) instead of floating point. 

The conversion from one colour range to 
another is made at the same time as a 
change in size of the image. Size is changed 

RISC User October 1989 


by ratios of areas between the input and 
output: the total weight of r, g, and b in the 
source area is calculated using the fixed 
point arithmetic, and this result is then 
approximated to the output using error 
diffusion to preserve information (for 
example, consider halving in size an image 
with adjacent pixels of intensities 1 and 2; 
the output pixel needs to be value 1.5, so the 
0.5 error is sent to adjacent pixels to keep 
the overall colour the same). 

Conversion from colour to monochrome 
shades of grey is done with the CIE 
luminance weights for r, g and b (0.30, 0.59, 
0.11) which is the standard conversion for 
broadcast television. Altering these values 
(rwt, gwt and bwt) in the program allows 
production of colour separations of the 
original picture. 

USING THE PROGRAM 

ChangeFSI can take RISC OS sprites 
from 16 or 256 colour modes. If there is a 
palette it will be used, otherwise the standard 
16 and 256 colour Desktop palettes are used. 
There is an example picture ‘Acorn_21' on the 
disc just in case you haven't any large colour 
pictures. The program can also handle a 
number of proprietary formats, and these are 
explained later. 

There are two ways of using ChangeFSI. 
Firstly, it can be run as a normal program in 
which case it will prompt for the various 
parameters it needs. Secondly, it can be 
copied to your library and invoked using 
‘ChangeFSI followed by the parameters. The 
command ‘ChangeFSI -help will print out 
details of the command’s function, its syntax, 
and the various image formats supported. The 
format for the command line version is: 

*ChangeFSI <source> <dest> <mode>(c|d|tl 
[<xscale> [<yscale>]] 

Source and dest are the filenames of the 
source image and the destination image 
respectively. Mode is the mode to convert 
the image into. If you wish to specify the c or 
d options explained above, then the 
appropriate letter should follow the mode 
number with no space, for example 20d. The 
t option causes the image to be converted 
using no tints in 256 colour modes, or 
sixteen grey levels in 16 colour modes. 
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Xscale and yscale are the seal© factors 
for mapping from the input to output images. 
These are in the form x:y where x is the 
multiplier and y the divider* They are 
automatically reduced to the lowest form, so 
you can specify the values which are most 
convenient. For example* when going from a 
multi-sync to a normal mode you could use 
the factors 640:640 and 256:512. If no scale 
factors are specified then 1:1 Is assumed, 
while if a single factor is given then it is used 
for both the xand y directions. 

ChangeFSI reads the image from disc as 
it is needed, and builds the output image in 
memory. This is then saved once the entire 
image has been converted. A percentage 
indicator is displayed during the conversion, 
and mode 0 is selected to reduce the video 
bandwidth and hence increase the speed. A 
further substantial speed increase can be 
achieved by using ‘RM Faster Basic before 
running the program. 

Here are some examples of what 
ChangeFSf can be used for, together with 
the appropriate parameters: 

Make “standard palette” versions of 
existing 256 colour images (for example the 
Watford digitiser plus colour board doesn't 
use the standard palette). 

ChangeFSI pic pic 13 
for a coloured Watford picture. 

Or convert a colour picture to something 
you can see on your high res mono monitor, 

ChangeFSI in out 18 

Or convert a colour picture to grey scale. 

ChangeFSI in out 20 

Or change a 512 by 480 image to the 
standard aspect ratio. 

ChangeFSI in out 15 640:512 512:480 

Or change the Acorn screen (on the disc) 
to digital r, g, b 

ChangeFSI Acorn_2i tt 20d 

There are of course many more uses 
such as making miniatures of pictures, 
animated sequences of pictures changing 
size, converting Artisan pictures to the 
Desktop (try looking at the Artisan Garden 


with the Desktop In 256 colours and 
ChangeFSf s version - the stripes ,on the 
lawn vanish with the standard version). 
Obviously you will need to have captured 
input as a sprite first! 

One point to note is that ChangeFSI has 
built-in to it the concept of RISC OS pixel 
shape, so when translating between modes 
where the pixels have different shapes you 
don’t have to specify scale factors, as this is 
done automatically. 

ChangeFSf can also convert from non 
RISC OS sprite formats while doing all of 
the above processing. It currently 
understands the Video Electronics ArVis 
format (5 bits of r, g and b), the 
CadSoft/Millipede Prisma format (256 
colours from 2 s *), the CompuServe GIF 
format (also 256 colours from 2 2 *) (rather 
slow, this one), PC ,P1C files and 224 colour 
displays obtained from ray tracers like QRT 
and RT (indeed, this is how the Acom_21 
picture was obtained in the first place!). 
Future versions of the program will cater for 
other formats such as TIFF and IFF. Adding 
a new format involves additional code for 
three distinct operations: 

1) The program must be changed to 
correctly recognise the format of the image, 
either by some key in the filename, or by the 
contents of the file itself. 

2) A routine must be written to extract the 
image size and colour paiette mapping from 
the image file. 

3) PROQiprow has to be modified to 
allow a complete row of pixels to be read 
from the source image. 

By studying the program it is possible to 
see how the extra code needs to be 
structured. If you do implement any extra 
formats, then please send them either to 
RISC User, or me, Roger Wilson, directly at 
Acorn, so that they can be included in a 
future version of the program. 

Further information on dithering can be 
found in the book “Digital Halftoning* by 
Robert Ulichney published by the MIT Press, 
ISBN 0-262-21009-6, a book which l wish I'd 
had when I started writing the program, 
rather than when it was nearly finished! [JFJ 
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Complete On-site 
maintenance for just 


£ 25.00 


+VAT 


This maintenance is for one year 
and includes: 

* 24 hour response to your call 

* Unlimited call-outs during the year 

* Replacement Equipment if fault can 
not be rectified on-site (subject to 
availability) 

• Additional cover for monitor - £10 

• Optional 3 year ‘Peace of Mind* cover 
available 

• Nationwide cover provided by Cray 
Electronics PLC for Beebug 


Beebug are now providing free on-site 
maintenance with all A3000 and 
Archimedes 400/1 series computers 
purchased after September 14th. 

Until 31st October we are able to offer 
this service to existing owners of an 
A3000 or 400/1 series Archimedes for 
just £25 plus VAT. If an Acorn monitor 
was purchased with the computer, this 
may be included for an additional £10 
plus VAT. 

Vou will need to be a Beebug/RISC 
User member to benefit from this 
service, and may subscribe for £14.50 
at the same time. 


Apply now enclosing serial number of computer and 
monitor (if applicable) and date of purchase along with the 
appropriate payment/credit card number to: 

Beebug Ltd., 117 Hatfield Road, St.Albans, Herts., AL1 4JS. 

You may telephone your order on (0727) 4Q303 or FAX us on (0727) 60263 


AN EXTENDED SPRITE INFO UTILITY 


by Le© Calcraft 


The command *SInfo gives information 
about resident system sprites. But it is.no 
help where Wimp sprites or user sprites are 
concerned. When 
debugging a pro¬ 
gram which uses 
user sprites, this can 
be a serious set¬ 
back. Moreover, 

*3info gives no 
information about 
each sprite apart 
from its name. The 
accompanying utility 
provides a new star 
command ‘Xsinfo to 
fill this gap* dis¬ 
playing the address 
of the sprite area and 
its size, together with a listing of ail resident 
sprites, their pixel sizes, their native mode, 
and their mask status. 

The command Xsinfo takes a single 
parameter as follows: 

0 for System sprites 
t for Wimp ROM-based sprites 
2 for Wimp RAM-based sprites 
A hex address for user sprites 
If you issue the command without a 
parameter, syntax help is provided. 


Basic program. Once installed* the utility 
may be called at any time as described 
above. 


♦XSINFO 2 








Extended Sprite Info 








Wimp Sprites at mmw 







Sprite area-3972 

0 byteCs) free 
Sprites present: 18 







nask 

■keys 

34 

by 

17 

node 

12 

uith 

snlkeys 

17 

by 

9 

node 

12 

with 

flask 

!p ipedrean 

34 

by 

17 

node 

12 

with 

nask 

file dde 

34 

by 

17 

node 

12 

no 

Mask 

snail dde 

17 

by 

9 

node 

12 

no 

Mask 


♦XSIHFQ 

XSinfo takes a parameter: 

0 for systen sprites 

1 for Mi up sprites (ROM) 

2 for Wimp sprites (RAM) 

fi hex address for user sprites 


Response to Xsinfo 

To install the utility, type in the listing, and 
save it to disc. When you run the program it 
will create the machine code utility, and save 
it to disc in the current directory using the file 
name Xsinfo and file type &FFC (utility). To 
install it in the Library directory for instant 
use, type ‘DIR $,Library before running the 


Response to Xsinfo 2 (RAM-based Wimp sprites) 


10 REM >XsinfoSrcfl 

20 REM Program Sprite Info Utility 

30 REM Version A 0*1H 

40 REM Author Lee Calcraft 

50 REM RISC User October 1989 

60 REM Program Subject to Copyright 

70 ; 

80 MODE 12 
90 DIM code si000 
100 cr$=CHR$10+CHRS13 
110 width-3: heights :mask=5 
120 free=5:mode=6:size=6 
130 syst~7 :REM 0 for syst, or 256 
140 type=S:count=B:oldsp=9 
150 no=10 :REM Number of sprites 
160 addr=Il :REM sprite base address 
170 i 

180 FOR pass=0 TO 3 STEP 3 

190 P%-code 

200 [OPT pass 

210 STMFD R13!,{R14J 

220 MOV oldsp,R13:MOV type,#4 

230 LDRB R0,[R1] :CMP R0,#0 

240 BEQ help \No param so Help 

250 MOV R0, #16 :MOV R2,#l«3l 

260 SWI "XOSKeadUnsigned" 

270 LDMVSFD Rl3! r (FC} 
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280 

MOV 

type ,R2 ;MOV addr,R2 

770 

SWI 

"OSJfriteO" 

290 

CMP 

R2,#0 :MOVEQ syst,#Q 

780 

BL 

getdata :BL outline 

300 

MOVNE 

syst,#256;BEQ cont 

790 

ADD 

count,count,#1 

310 

CMP 

R2, #3 :BHS cont 

800 

CMP 

count,no:BLS catloop 

320 

SWI 

"XWimp BaseOfSprites" 

810 

B 

quit 

330 

LDMVSFD R13!f{PC} 

820 

.help 


34 0 

CMP 

type,#1 

830 

ADR 

RQ,helptxt:SWI "OSWriteO" 

350 

MQVEQ 

addr,R0 \ROM Wimp sprts 

840 

.quit 


360 

MOVNE 

addr,Rl \RAM Wimp sprts 

850 

SWI 

"OSJSTewLine" 

370 

\addr= 

base for user or Wimp sprts 

860 

LDMFD 

R13!, (PCK 

380 

.cont 


870 

.getdata 

390 

ADR 

R0,text1rSWI "OSWriteO" 

880 

STMFD 

R13!,{Rl 4} 

400 

CMP 

type,#4 ;BHI user 

890 

ADD 

R0,syst,#13:MOV Rl,addr 

410 

CMP 

type,#1 :CMPME type,#2 

900 

MOV 

R2,R12 ;MOV R3,#£I0 

420 

BEQ 

wimp 

910 

MOV 

R4,count:SWI "XOS SpriteOp" 

430 


\System heading 

920 

MOWS 

R13,oldsp:LDMVSFD R13!,{PC} 

440 

ADR 

R0,text2:SWX "OSWriteO" 

930 

BL 

name :ADD R0,syst,#40 

450 

B 

skip 

940 

SWI 

"XOSSpriteQp" 

460 

.wimp 

VWimp heading 

950 

MOWS 

R13, oldsp 

470 

ADR 

R0 r text3: SWI "QS WriteO" 

960 

LDMFD 

R13!,[PC} 

480 

B 

skipl 

970 

. name 


490 

.user 

\User heading 

980 

STMFD 

R13 l , { RQ-R3, Rl 4 ] 

500 

ADR 

R0,text4:Swi "QSJWriteG" 

990 

MOV 

R0,R2 \Spr name 

510 

.skipl 


1000 

MOV 

R1,R3 :SWI "OS WriteN" 

520 

MOV 

R0, addr :MOV R2,#0 

1010 

MOV 

R2,#14 \Pad spr name 

530 

MOV 

R3,#0 \Flag hex 

1020 

SUB 

R2 r R2,R3 

540 

BL 

number 

1030 

. out2 


550 

. skip 


1040 

SWI 

256+32 i SUBS R2,R2,#1 

560 

MOV 

R1,addr :ADD RG,syst,#8 

1050 

BNE 

out 2 

570 

SWI 

"XOSSpriteOp" 

1060 

LDMFD 

R13! , { R0-R3,PC} 

580 

LDMVSFD R13!, {PC} 

1070 

.outline 

590 

MOV 

size,R2 :MOV no,K3 

1080 

STMFD 

Rl31, [ Rl41 

600 

MOV 

free,R5 : ADR R0,indent1 

1090 

MOV 

R0,width;MOV R3,#l 

610 

SWI 

"OS_Write0" 

1100 

MOV 

R2,#6 *BL number 

620 

ADR 

R0,text5 \block size 

1110 

SWI 

"OS WriteS" 

630 

SWI 

"OS WriteO 11 

1120 

EQU5 

" by"+CHR$G;ALIGN 

640 

MOV 

R0, size :MOV R2,i0 

1130 

MOV 

R0,height:MOV R2,#5 

650 

MOV 

R3,#1 \Flag decimal 

1140 

BL 

number ;SWI "OSWriteS" 

660 

BL 

number;ADR R0,indentl 

1150 

EQUS 

" mode"+CHR$0:ALIGN 

670 

SWI 

"GSJWriteO" 

1160 

MOV 

RO,mode :MOV R2,f4 

680 

SUB 

free,size,free 

1170 

BL 

number :CMP mask,#0 

690 

MOV 

R0,free :MOV R2,#0 

1180 

BNE 

amask:SWIEQ "OSJflriteS" 

700 

BL 

number :ADR R0,text6 

1190 

EQUS 

11 no mask"+CHR$Q 

710 

SWI 

"OSJWriteO" 

1200 

ALIGN 

:B out3 

720 

MOV 

RO,no :MOV R2,#0 

1210 

. amask 


730 

BL 

number :CMP no, #0 

1220 

SWINE 

"OS WriteS" 

740 

BEQ 

quit :MOV count,#1 

1230 

EQUS 

" with mask"+CHRSQ:ALIGN 

750 

.catloop 

1240 

. out 3 


760 

ADR 

R0,indent2 

1250 

LDMFD 

R13!,[PC} \===Return=== 
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1260 .helptxt 

1270 EQUS "XSinfo takes a parameter:*+c 
r$ 


1280 EQUS " 0 for 
1290 EQUS ■ 1 for 
cr$ 

1300 EQUS " 2 for 

cr$ 


system &prites"+cr$ 
Wimp sprites (ROM)"+ 

Wimp sprites (RAM)"+ 


1310 EQUS " A hex address for user n 
1320 EQUS "sprites"+CHRS0 
1330 .text 

1340 SWI "QS WriteO" :MOV PC,R14 
1350 .indentl 

1360 EQUS cr$+" "+CHR$Q:ALIGN 
1370 . indervt2 

1380 EQUS cr$+" "+CHR$0■:ALIGN 

1390 -textl 


1400 EQUS cr$+"Extended Sprite Info" 
1410 EQUS cr$+CHR$G:ALIGN 
1420 .text2 

1430 EQUS "System Sprites"+CHR$0:ALIGN 
1440 .text3 

1450 EQUS "Wimp Sprites at s"+CBR$0 


1460 ALIGN:.text4 


1470 EQUS "User Sprites at &"+CKR$0 
1480 ALIGN;.textB 


1490 EQUS "Sprite area="+CHR$0:ALIGN 
1500 .texts 

1510 EQUS " byte <s> free"+cr$ 

1520 EQUS " Sprites present: "+CHR$Q 
1530 ALIGN:.number 


1540 STMFD R13! f {R14} 

1550 MOV R1,R12 :CMP R2,#0 

1560 MOVEQ R2,#256 tCMP R3,#0 

1570 SWIEQ "XOS J3onvertHex8" 

1580 MOWS Rl3, oldsp: LDMVSFD R13!, {PC) 
1590 SWINE "XOSConvertCardinal4" 

1600 MOWS R13, oldsp: LDMVSFD R13!,{PC} 
1610 .numbl 

1620 CMP R2,# 8 0 :RHI numb2 

1630 CMP R2, # 0 :BEQ numb2 

164 0 SWI 256+32 : SUBS R2,R2,#1 

1650 BHI numbl 

I860 .numb2 

1670 SWI T, OS_WriteO" :LDMFD R13!,{PC) 

1680 1NEXT 

1690 SYS "OS File",10,"XSinfo",£FFC,, co 


de,P% 


nn 


Emerald Publishing 



The advanced user guide helps you get the 
most from Acorn DTP. With full operating 
instructions, hints and tips, style guidelines, 
instructions on creating a wide variety of 
documents, and on how to exploit its 
powerful features to the full, this book leads 
you through ownership of Acorn DTP from 
installation to becoming an expert user. It 
goes far beyond the official User Guide. 

Available now from Emerald Publishing, 
Dept R, PO Box 324, Cambridge CB1 3HB. 
£14,95; examples disk, £3.95, p&p included 
Cheques payable to Emerald Publishing. 
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David Spencer takes a look at the hardware that makes the Archimedes tick. 


Many Archimedes owners (and in fact 
computer owners in general) have little or no 
idea what makes their computer tick, and this 
includes some very experienced programmers 
that I know. In this short series \ will explain the 
basics of the Archimedes hardware, but 
without going into the sort of detail which 
requires a degree in electronic engineering to 
understand. 

GETTING DOWN TO BASICS 

Before getting down to the details of the 
Archimedes we will take a brief look at digital 
electronics. In electronics, a signs! is any piece 
of information carried within a circuit. For 
example, the wire connecting a record deck to 
an amplifier carries a signal (or two for a stereo 
system) representing the information stamped 
on the record. On the record the information is 
stored in the groves, while when the sound 
emerges from the speaker It is the form of 
pressure waves that reach our ears. However, 
between these devices the signal is 
represented by a varying voltage which wifi be 
carried along a wire, or a track on a printed 
circuit board etc. What is important Is that 
some arbitrary information, in this case music, 
can be represented by a voltage within a 
circuit. Furthermore, the voltage can take any 
value between two extremes. In our example 
the value of the voltage corresponds to the 
volume of the music. 

The range of values the voltage can take 
depends entirely on the circuit in question. For 
the output of a record deck the vottage might 
range from QV (V=volt) for absolute quiet to 
IQOmV (1mV=1/1000 V) for maximum volume, 
while the same signal when amplified to drive a 
loudspeaker could range in values from OV to 
45V. The critical thing is that any circuits 
connected together must agree about the 
range of voltages they use. If you were to 
connect the loudspeaker output of an amplifier 
back to the input you would most likely cause a 
lot of damage because the Input signal would 
be several hundred times the expected 
voltage. 

The situation just described is an analogue 
system. This is the term used when the voltage 
of the signal is proportional to some varying 


information, such as music, in contrast, a 
computer system at the fundamental machine 
code level works in binary. Therefore, a signal 
representing a binary digit (bit) will only ever 
take two voltage levels, as It represents either 
the binary value Oort. Such a setup is called a 
digital system. For historical reasons, computer 
systems tend to be powered by 5V power 
supplies. You might therefore expect binary 
signals to be represented by voltages of OV and 
5V. However, this is the ideal case, and for a 
number of practical reasons these levels would 
prove unworkable. A further consideration is 
noise. In electronic terms noise is an unwanted 
signal which interferes with genuine signals, 
typically causing the signal voltage to change 
slightly. It is highly desirable that even if our 
digital signal is subjected to noise that it is still 
possible to determine whether it represents a 
one or a zero. If this was not the case, then the 
computer would most likely crash each time a 
car with a faulty supressor drove past for 
instance. For this reason, instead of using one 
single voltage to represent a zero, and a 
different voltage for a one. two ranges are used. 
This is shown in figure 1. 


5V 






- 4.4V 

Logic T 

2.4v 


' 


0.8v 






k0.2v 

Logic O' 

OV 





Figure l. Logfc voltage levels 


It can be seen from figure 1 that a zero may 
be represented by any voltage between OV 
and about 0.8V, while a one has the range 2V 
to 5Y Any voltage within either of these ranges 
will be correctly recognised by components in 
the circuit as representing a zero or one. 
However, devices that generate signals do so 
to a much tighter tolerance. Typically, for the 
devices used in the Archimedes, a zero will be 
output as 0.2V, and a one as 4.4V, these being 

15 


RISC User October 1989 







UNDER THE LID 


marked on the diagram as the thick lines. You 
should be able to see that even if noise does 
alter the voltage of the signal significantly, it is 
unlikely to go out of the allowed range * and can 
therefore still be interpreted correctly. 

CATCHING A BUS 

Having looked very briefly at the whys and 
wherefores of digital electronics we can turn our 
attention to the signals found in the Archimedes, 
or in fact any computer. Although a single bit 
can be represented by one signal, this is not on 
Its own very useful. In general, several bits are 
treated together to form a binary number. As it 
takes one electronic signal for each bit, an n-bit 
number requires n signals, and hence n 
separate connections within the circuit. Such a 
set of connections is known as a bus. 

Although the term bus refers to any such 
set of related connections, there are two 
important buses present in all computer 
systems - the address bus and the data bus. 
These buses are used whenever the computer 
reads or writes memory. Not only does this 
Include all the reads of program instructions 
and data, but in the case of the Archimedes, alt 
accesses to peripheral devices such as the 
keyboard and disc drive. This is because on 
the ARM f all peripherals are treated as special 
case memory. 

When the ARM processor reads or writes a 
memory location it starts by putting the address 
of the location as a binary number on the 
address bus. The hardware of the computer, 
including the memory controller MEMO which we 
will come back to later, then uses this address to 
select a particular location within the RAM or 
ROM chips, or one of the peripheral devices. 
Simultaneously with this the ARM also sets up a 
number of signals to indicate whether it wants to 
read or write the selected location, and whether 
it wants to write a whole word, or just one byte 
(as would be the case using the STRB 
Instruction). Once this has happened* if the 
operation is a read from memory then the 
memory device (RAM, ROM etc.) puts the value 
on the data bus and the ARM reads this in. For a 
memory write, the ARM places the data on the 
bus and the memory devices stores it. 

In the Archimedes* the data bus is 32 bits 
wide* because the ARM is a 32 bit processor, 
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The address bus on the other hand Is only 26 
bits, giving an addressing capability of 
64Mbytes* or 16Mwords, We shall look in 
much more detail later at how the addressable 
locations (called the address space) are 
arranged. 

PUTTING IT TOGETHER 

Having explained briefly some 
fundamentals of digital electronics, and the 
idea of a bus, we can now start to look at the 
Archimedes Itself, Figure 2 shows a so-called 
block diagram of the hardware. In such a 
diagram, all the major building blocks of the 
circuit are shown, together with the important 
interconnections between them. However, the 
detail of every individual component is not 
shown. When studying the principles of a 
complex system, a block diagram is generally 
much more use than a full component level 
(schematic) diagram, because the latter tends 
to become rather cluttered and confusing. 

Looking at figure 2, you can see in the centre 
the ARM processor and the memory controller 
MEMO. The other two large blocks are the 
peripheral controller IOC* and the video 
controller (VIDG). Together* these four chips form 
the ARM chip set which was specially designed 
by Acorn. As these are the key chips, it is these 
that we will be.concentrating on. You will also 
see the RAM and ROM in figure 2 t together with 
the specific chips for controlling individual 
peripheral devices such as the disc drive and 
serial port. 

The Interconnections between blocks are of 
two forms. The thin lines represent individual 
signals, whilst buses are shown as a thicker 
line. On some block diagrams you may also 
see buses drawn as two parallel lines - It a(l 
depends on what takes the designer's fancy. 
The same system Is also used on schematic 
diagrams, although in this case because every 
connection must be clearly depicted individual 
signals that spilt off buses are labelled. 
Another set of vital connections that you will 
not find on the block diagram, and probably not 
on a schematic, are the power supply 
connections. Every single chip in a Circuit 
requires a power supply, and as almost all 
digital chips use a single +5V supply as stated 
earlier, it is usually simpler to omit power 
supply connections. On a block diagram they 
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are missed out altogether, while on a 
schematic a table is normally used to show the 
connections for each chip. 


The address and data buses are clearly visible 
on the block diagram. The address bus connects 
between the ARM processor and MEMO, and 
also to a set of chips called latches. A latch is a 
device which can be instructed to store a binary 
number by means of a control signal. The types of 
latch used on the address bus are called 
transparent latches. With these, the number is fed 
straight through until the control signal is applied. 
The outputs of the latch are then frozen while the 
input can continue changing until the control 
signal is removed at which point the outputs follow 
the inputs again. The reason for needing the 
latches is interesting - the ARM is such a fast 
processor that having started to access a memory 
location it moves onto the next access before the 
first one is completed. This would result in the 
address seen by the memory changing before it 
has a chance to use It, Therefore the latches are 
used to hold the address for a short while until the 
memory has a chance to catch up. This latched 
address bus is then connected to the ROMs, and 
the peripheral devices including IOC. We will 
explain next month how the peripheral devices 
use the address bus. 


You might have noticed that the address bus 
does not connect to the RAM chips, which 
appears to be contrary to what we said earlier. 

The reason for this is 
the way in which the 
RAM chips are 
arranged internally. 
Rather than having a 
linear list of locations 
accessed by a single 
address (as used by 
the ROMs), the RAM 
Chips arrange their 
locations In a grid, 
with each location 
being selected by a 
separate row and 
column address. This 
method simplifies the 
internal design of the 
RAM chips, and also 
reduces the number 
of pins on each chip, 
because the two 
addresses are ted in 
one after the other on 
the same set of pins. 
It is the job of MEMO 
to split the address 
up as needed, and 
this will be covered later when we explain the 
functions of the main chips. 

The data can also be seen originating from 
the ARM, and passing directly into VIDC, the 
ROM and RAM. The lower half (sixteen bits) of 
the data bus is then connected into two sets of 
latches, both in parallel, but in opposite 
directions. These are used to connect the data 
bus to IOC and the peripheral devices. Only 
sixteen bits are used because the majority of 
peripherals used in computer systems work in 
eight or sixteen bit chunks, rather than the 
mammoth thirty-two bits of the ARM data bus. In 
fact, even JOG which is an integral part of the 
ARM chip-set uses only eight bits. The latches 
that face away from the data bus (i.e. those 
which latch the data from the data bus) serve a 
similar purpose to those on the address bus - 
they keep the data stable long enough for the 
peripheral devices to deal with if. This is 
necessary because most devices that have to 
communicate with the outside world (meaning 
keyboard, disc drive etc.) will work at a much 
slower speed than the ARM itself. 
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Figure 2. Simplified block diagram of the Archimedes 
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The purpose of the latches which feed data 
onto the data bus is different, AN the peripheral 
controlling devices are asynchronous , which 
means that once the processor has started a 
read operation from one of them, it is not sure 
exactly how long the operation will take, and 
hence when it will finish. Therefore, the latches 
are used to store the data read from the 
peripheral controller, so that the ARM does not 
have to synchronise its reading of data exactly 
with that of the device being read, 

TRISTATE LOGIC 

Finally this month we will look at a very 
important concept in computer circuits. When we 
introduced the idea of digital signals, we implied 
that all signals had to be at one of two voltages, 
representing either a zero or a one. But, look 
again at the block diagram of figure 2. A number 
of devices can feed data onto the data bus - 
namety the RAM, ROM and I/O latches, and the 
ARM itself. Now, in a binary system all of these 
devices must be outputting either a zero or a one 
signal onto the data bus at all times, simply 
because there are only two possible output 


states to choose from. However, this will lead to 
contention because it is most probable that each 
device will be trying to put a different number 
onto the data bus, and these will interfere with 
each other. For example, consider the simplest 
case of just two devices and a single bit of the 
data bus. If the first device is trying to put OV on 
the data bus line, and the second Is putting 5V 
we have a contention problem. In practice, 
exactly what happens depends on the particular 
type of chips connected to the bus, but it is 
almost certain that the circuit will be thrown into 
chaos. 

To avoid this, most outputs have three states. 
They can either be a binary 'O' or *1', as before, 
or can be totally disconnected from the circuit. 
This disconnection is done by means of a control 
signal. The circuit is arranged so that at any time 
only one device has its outputs enabled, and 
hence only one number is being put onto the 
data bus at any time. 

Next month we wilt look in some detail at 
the functions of the ARM chip set. rrn 


,# F I R S T DB 

ADVANCED STATISTICAL SYSTEM 

For Acorn Archimedes; BBC Models B, B+ and Master Industry Standard" machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 

Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing variables and data subsets, Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparameiric methods. 
Unnvalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 

Price £120-El 80 (machine and version dependent). Special RISC USER discount available. 
There's far too much to describe here. Get full information now from: 

Serious Statistical Software, Lynwood. Benfy Heath Lane, Willasfon, South Wircal 164 1SD Tel, 051 327 4268 
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PipeDream 3 


Reviewed by Mark Seafey 


Ward processors, spreadsheets and 
databases are undoubtedly the most popular 
applications for the Archimedes, and indeed 
any micro. PipeDream, from Cotton Software, 
integrated ail three into a single package, and 
has achieved a deserved measure of 
success, not only on the Archimedes but in 
versions for the Cambridge Computer Z8S 
and the PC market. Now Colton has launched 
PipeDream 3, a completely rewritten version 
of PipeDream {reviewed in RISC User 
Volume 1 Issue 8} which now incorporates the 
previously separate spelling checker 
(reviewed in Volume 2 Issue 2). 


PipeDream 3 now conforms fully to the 
standards for RISC OS applications. Indeed, 
Colton Software has coined the name 
Riscware for such software. 

All of the functionality of earlier versions of 
PipeDream remains: what has changed 
completely is the user Interface. Furthermore, 
by running under RISC OS, text, data and 
graphics may be readily Imported into a 
PipeDream document, or exported to other 
applications. The results fully justify the outlay 
required for this software, and upgrade paths 
are available for existing users. 


Other new features permit references in 
one worksheet to be made to slots in others, 
a form of external reference. Where 
necessary, PipeDream 3 now automatically 
loads the sub-sheets and likewise updates 
all external references for you as 
appropriate. In fact, Colton has employed 
improved memory com pact Jon techniques to 
cram even more data into the available 
memory. PipeDream 3 makes full use of the 
mouse for pointing and for menu selection, 
whilst retaining (in a slightly modified form) 
the previous keyboard control. 

For a more detailed 
explanation of the philosophy 
behind PipeDream I suggest 
you look at either of those 
earlier RISC User reviews. 
Simply put PipeDream allows 
word processing, spreadsheet 
and database functions to take 
place as appropriate on 
(alpha)numeric data and text 
on the same basic worksheet. 
Thus all functions are totally 
integrated. 

You can then process the 
data either as text to be 
formatted and subjected to 
most of the same operations 
possible with any powerful 
word processor, or, if the slot is 
designated as an expression 
slot containing numeric data or 
formulae it will be treated and 
manipulated in true spreadsheet or database 
style. 

The excellent manual {a feature of Colton 
products, it seems) explains all this very well 
and runs to substantially over 400 pages. 
Beware though! If you have not used 
PipeDream before, the use of tabbing (to 
move about the underlying worksheet, and 
the way word-wrap is handled are quite off- 
putting at first. 

AH PipeDream applications are based 
upon a spreadsheet-style grid of rows and 
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Graphics incorporated in a worksheet 
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columns called a worksheet. PipeDream text 
takes as its left-hand margin the start of 
whichever column is first selected, spreading 
rightwards as you type across the screen, 
pushing the right-hand limit of that slot 
beyond the column boundary, as far as 
display is concerned, yet remaining in it 
(because that’s where it started) for the 
purposes of manipulation and formatting. 

Like most other word processors, 
PipeDream 3 will start a new line when Return 
is pressed, and there is a welcome option to 
denote line separators as either LF, CR or LF- 
CR. Scrolling is relatively smooth, though not 
as smooth as with, say, Clares’ Graphic Writer, 
but this is at the expense of the full operation 
of the window slider. When you think of the 
amount of potential information to be updated, 
this should not be a real worry. 

USING PIPEDREAM 3 

Gone are the pull-down menus from the 
bar at the top of the screen; instead 
PipeDream 3 works in full Wimp fashion, 
with standard RISC OS menu windows for all 
PipeDream functions, but most of these can 
also be selected as keyboard operations 
much as before. Most of the key 
combinations are identical to the earlier 
versions of the software too, except that the 
use of the Alt key (somewhat alien to the 
users of Acorn’s micros) has been replaced 
by Ctrl. Thus, if you instinctively used to 
press Alt-SS to swap the case of the 
character at the caret (the RISC OS text 
cursor), Ctrl-SS now does the same thing. 
And of course there are extra functions too. 

The by now standard RISC OS dialogue 
boxes also appear where further parameters 
are required - for the printer options or the 
number of trailing decimal digits, for example. 
This new user interface is perhaps the most 
significant of the many improvements. 

For flexibility and range of features the 
software is now hard to beat. Because 
PipeDream 3 operates from the Desktop, all 
the printer and file-handling features which 
that supports are available. Indeed, greater 
use can now be made of meaningful 
directory structures - documents in one, say, 
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and dictionaries in another. It also means, for 
example, that it is very easy to highlight a 
block of data, save this as a file which can be 
dragged into Minerva’s GraphBox, and the 
resulting graph file similarly dragged back to 
your PipeDream document to be positioned 
alongside the original data (in less time than it 
takes to describe). 

NEW FEATURES 

In the first place, Installation of the 
software on your system is much easier than 
it was in earlier versions. As a security 
feature you will also need to enter your 
registration details the first time you use 
PipeDream. 

One extra, of course, is the inclusion of the 
previously separate spelling checker, and this 
is one reason for the higher price of 
PipeDream 3 (compared with earlier 
Pipedreams). The latest version comprises a 
dictionary of more than 90,000 words, but this 
is surely no more than an essential 
requirement for any serious word processor 
these days. PipeDream 3’s auto-spellcheck 
runs pretty quickly, and seems better able to 
keep up with a reasonable typing speed than 
before. 

Other enhanced features of this part of 
the software make it a delight to use. There 
are anagrams and subgrams (an anagram 
using a subset of letters), while the merging, 
handling and dumping of dictionaries works 
well and efficiently. All dictionary operations 
can work over multiple documents. 

Files in many formats (View/Viewsheet, 
Lotus 1-2-3, 1st Word Plus, Tab, CSV) as 
well as earlier PipeDream files can be 
loaded and saved, and Acom DTP format is 
catered for as well. There is full compatibility 
with the Z88 system and a Z88 filing system 
can be installed and run from the Desktop. 
The manual goes into particular detail over 
Lotus file transfers. 

There is better (and easier) recovery of 
blocks, columns and rows as well as words. 
A default buffer of up to the 50 of the most 
recent deletions is maintained (and this can 
be varied up to a maximum of 255). 
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The Macro Recorder has been simplified, 
and ways to define specific keys or to 
execute command sequences (which you 
might need on start up T for example) are 
clearly explained in the manual. 

CHANGES TO SPREADSHEET FUNCTIONS 

PipeDream 3 now has natural re¬ 
calculation, getting round those occasions 
when forward referencing of cells would 
either cause an error or force the re¬ 
calculation to be carried out several times. 
Re-calculation now works on a set of 
formulae until a specific result is achieved, 
and ail re-calcutation is arranged so as to 
appear to be multi-tasking. 

References to cells in other sheets are 
now possible, replication of blocks of cells 
has been substantially improved, and there 
are enhancements to the possible display 
formats - for example for negative numbers, 
dates and large numbers. Some half dozen 
new spreadsheet functions have been 
added, bringing the total to over sixty, 

DATABASE FUNCTIONS 

This area has, perhaps, received least 
attention, but may turn out to be one of the 
most useful for some applications. Imagine a 
database where fields represent the prices, 
locations, facilities etc of houses (for an estate 
agent perhaps). Imagine that you also want to 
Include lengthier descriptions of certain 
features. Using a conventional database, this 
data would consume a much longer field than 
was probably allowable or convenient. The 
maximum permitted by System Delta Plus, for 
example, is 255 characters. 

PipeDream will allow fields as wide as 
your sheet can be. Since they can be multi¬ 
row fields, they are theoretically unlimited, 
and yet such a database could still be sorted 
on price and all the associated text put in its 
correct place too. The syntax of the 
database commands has been usefully 
improved too for PipeDream 3. 

DOCUMENTATION 

The original PipeDream manual 
impressed, but that for PipeDream 3 is even 
better; There is an initial tutorial which really 
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does assume no previous knowledge - three 
lines are used to identify and describe keys 
like 0 (zero) and Return. This introduction 
takes up about 70 pages and is paced so as 
to introduce you in a logical way to all of 
PipeDream's main features. 

This is followed by a section that takes 
you through a likely sequence of activities to 
build up a typical document (a report) where 
numerical tables and data might also be 
included. 

Then, for seasoned users (and maybe 
the merely curious), there is a full reference 
section of some 200 pages, of which 60 or 
so contain a summary table and longer 
explanations of each command in 
alphabet tea I order, Excellent 

Admittedly not everything is covered, but the 
product is so well supported by Colton (e.g. free 
updates of PipeDream 3 to registered users) 
that this is no cause for worry. 

CONCLUSIONS 

There are still some minor niggles, like 
the absence of a single key indent. Marking 
blocks of text in units smaller than one slot is 
not possible either. PipeDream 3 still doesn’t 
include all the features that you might expect 
to find in a more expensive and dedicated 
word processor, spreadsheet or database, 
such as Lotus 1-2-3 or Logistix, or the 
forthcoming Minerva Multistore or dBase IV 
for example. But that is hardly the point. 
PipeDream scores in being very easy to use, 
very comprehensive in what it has to offer, 
and superb at handling a wide variety of data 
types in a fully integrated fashion. 


Product 

PipeDream 5 

Supplier 

Colton Software, 

Broadway House, 

149-151 St Neats Road. 

Hardwick, Cambridge CB3 7QJ 

Tel. 0954 211472 

Price 

£169.05 Inc. VAT (complete) 

£34.50 Inc. VAT. (If returning your 
original PipeDream 2 with Spellcheck) 
£74.75 Inc. VAT (without Spellcheck) 

HI 
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The Archimedes Text Processor 


mmmr 


A New Type of Program 


Premier is an all purpose command driven text processor, capable of word processing, data 
bases, spreadsheets, customised mail shots, report generation, or any otter application 
involving the manipulation of text* Why use several, possibly incompatible software 
packages, when Premier can provide all your needs. 


Write or phone today for full information, a £5 
refundable demo disc, or the latest version (2*04) 
with new 220 page manual for just £96 + vat. 
Dealer and educational discounts etc* available* 


Circle Software 



33, Restrop View, 
Purton, Swindon, 
Wilts. SN59DG 
Tel: 0793 770021 





























MASTERING THE WIMP 


by Le© Calcraft 

PART 2: CREATING WINDOWS 


Last month we took a brief overview of 
the Wimp system, and a simple multi-tasking 
demonstration program was supplied. As 
promised, we return to explore this program 
in some detaiL 

First of ail, If you experimented with the 
program as suggested, did you spot the 
inconsistency mentioned last month? It has 
to do with the way in which the window is 
updated. The window displays the time and 
date, but this is only renewed when the 
Wimp asks the task to redraw the window. If 
you move the window around the screen, the 
displayed time remains the same* and is only 
brought up to date when the window is 
scrolled, or when part of the window is 
uncovered. 



A small alteration to the program permits 
the full Wimp palette to be displayed. 


This illustrates the degree to which the 
Wimp handies ail routine activities without 
the need for intervention by the user's 
program. The Wimp only calls for help when 
it cannot get by unaided. As mentioned last 
month* such activities are handled by the so- 
called "Wimp^Poll" catl, which forms an 
anchor point for the dialogue between the 
Wimp and each concurrent task (the terms 
task and program are largely synonymous in 
the context of this series). 

We shall treat the “Wimp_PoN" routines in 
a future issue. This month we will concern 


ourselves with two of the calls which are 
normally made before calling SYS 
“Wimp^PoH". 

INITIALISING THE WIMP 

The first of these, SYS "Wimpjnitialise’v 
is an easy one. Its function is to tell the 
Wimp of the existence of the new task, and 
to allow the Wimp to assign a task handle (a 
unique number which wilt be used to identify 
the task in certain future operations), and to 
inform the task of the version number of the 
Window Manager module installed in the 
computer 


On Entry 

RG=Last Wimp ver no * 100 (at least 200) 
R1="TASK" (low byte=T\ high byte='K") 
R2~Poinfer to description of task 

On Exit 

RG=Current Wimp version number MOO 


Figure 1. 

SWI "Wimp_initialise” <SWi &400CO) 

Lines 150 and 160 of last month's 
program are all that is needed for this call. 
The first stores the word 'TASK" (literally) at 
location block%, while the second performs 
the call itself. See figure 1 for details of the 
parameters passed by this call, and the 
article "SYS Calls Explained" in last month's 
RISC User If you are unfamiliar with SYS 
calls, RO is given the value 200 (the latest 
version of the Window Manager), R1 holds 
the word "TASK” (literally), while the third 
parameter supplies a brief description of the 
task for the Task Manager display. On exit 
the variables version% and task% will hold 
respectively the version number of the 
Window Manager, and the task handle which 
it has assigned to the task. 

The parameter supplied to R1 by the user 
is a little unusual in that it is not a pointer to a 
text string, but the text string itself, it has the 
value &4B534154. Acorn have devised this 
little ruse to enable the RISC OS Window 
Manager to identify RiSC OS tasks. 
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VISA 


LINGENUITY'S SCSI interface card for the 
Archimedes and A3O0O 

1 / Up to twice the speed of the standard Acorn ST506 20MB Hard Drive upgrade. In more 
detail SCSI allows considerably faster Data transfer from computer to device over the 
conventional ST standard devices, be it a Hard Drive, Tapestreamer, CD ROM or any 
other SCSI device. 

Acorn-compatible filing system. The RISC OS environment is identical to Acorn's with 
ail SCSIFS commands behaving in the same way as ADFS and NETFS, All SWI calls 
within SCSIFS are as defined by Acorn. 

A maximum of 7 Devices per SCSI Interface card. Up to four of these can be Hard 
Drives (ADFS limitation). Other devices can be added. 

CD ROM-compatible for large data storage with this exciting new technology. Driver 
software is currently under development and will be available shortly. Please contact 
Lingenuityfor details and latest availability. 

✓ Tapestreamers, Printers, Scanners and other SCSI device-filing systems are being 
developed. Please contact UNGENUITY for further details. 

No limit to size of Hard Drive. The controller chip used on current ST506 Hard Drive 
interfaces limits the use of drives over 70MB. SCSI however has no fixed upper limit and 
therefore larger drives can be attached. 

All trademarks acknowledged 


WOOD FARM UNSTEAD MAGNA HALESWOfiTN SUFFOLK IP1& ODU 
TEL: 095 GS5 477 


Archimedes SCSI interface card 

Fitted internally this 1/2 width Eurocard will allow internal or external drives to be 
connected to your Archimedes, 

£199+ VAT 


A3 ao 0 S i I ht e tfa ce car d ^ 1 . = 

Fitted internally in the A3000 as a "minipodule 1 With the externa! drives available from 
UNGENUITY this must be the neatest solution for A3000 users 4 
£149+ VAT 


HARD DRIVES for the A3000 & Archimedes. 


20M8 for the A30OO 

Includes 20MB drive in an external case with A3000 internal "minipodule ” and ail cables to 
connect the drive to your A3QQ0. 

£475 + VAT. Larger drives are available t please contact UNGENUITY. 

45MB for the Archimedes 

Includes 45MB Hard Drive and mounting bracket, cabling and SCSI interface card l 

£499 + VAT Larger drives are available, please contact UNGENUITY. 


All UNGENUITY products are available direct or 
from good Acorn dealers . 

For further deatails please contact us at; 
















AN ICON SELECTOR SHELL 


Mike McNamara presents a set of procedures to implement on-screen buttons. 


As powerful as the Wimp system is. St is 
also very involved, and often, therefore, 
Ignored when writing small programs. 
However, It is possible to mimic one feature of 
the Wimp with relative ease - click-sensitive 
buttons. The program here does just this, it 
aliows any number of buttons (or icons) to be 
placed on the screen. When the Select button 
is clicked, the program works out which icon 
the pointer is over, and takes appropriate 
action, in the demonstration program, all that 
happens is that the icon name is displayed, 
but obviously you could include the routines in 
your own programs and use the clicks to 
perform more complex operations. 

ENTERING THE PROGRAM 

Start by typing in and saving the listing 
given below. The demonstration program 
uses the Wimp's sprites as icons, and 
therefore these must be saved to disc first 
using the following two instructions: 

SYS "Wimp BaseOfSprites” TO rom% 

SYS "OS_SpriteOp",&10C,rom%,"ICONS” 

Finally, before running the program, the 
RISC OS CofourTrans module must be 
loaded. To do this insert Applications disc t 
in the drive and enter ‘MOUNT followed by: 

ARMLOAD $. t SYSTEM .MODULES. COLOURS 

When the program is run, a number of 
icons are placed on the screen, as can be 
seen in the illustration. Clicking on most of 
these will simply display the icon name and 
its number. However, clicking on the [ A' icon 
(as used for the Desktop Task Manager) wilt 
cause the program to exit. 

USING THE ROUTINES 

It is a relatively easy matter to include the 
icon handling routines in your own programs. 
The procedure PROCintt defines the screen 
mode to use* the name of the file containing 
the icon sprites, and the information 
describing where to place the icons. The 
filename and mode in line 1120 can be 
changed as required. Because the 
CofourTrans module is used, the program 
will work in any screen mode, and with any 
sprite except ones defined using 256 
colours. Alternatively^ if the sprites will ail be 
in the same mode as the program is running 

RISC User October 1989 


in, then you can delete line 740 and change 
the &234 to &222 In line 560. This removes 
the need for CofourTrans to be installed. 
The string assigned to Button$ in line 1170 
determines the position of the icons on the 
screen. This consists of a number of entries 
concatenated together, each with the 
format \<sprltename>:<x>,<y>;<i> where 
spritename is the name of the sprite, x and y 
are the screen co-ordinates of the lower left- 
hand corner, and i is the icon number. This 
number has no significance to the program, 
but is used to identify clicks on the icon. 


1 FJiipfujifk: 2 


jiTR 

SaS 

j§H 
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Ell 


The example set of icons 


Looking at the program should make the 
syntax of this definition dear. As well as setting 
up Button$. the value of Number% in line 1160 
should be set to the total number of icons. 
Having executed PROCinit, PROCplace_button 
must then be called for each icon. This can be 
seen in tines 100 to 120 of the program. 

The main loop of the demonstration 
program repeatedly reads the mouse state 
and position, and if Select is pressed calls 
FNbutton_pressed to find which icon (if any) 
the pointer is over. This function returns the 
number of the icon under the pointer, or zero 
if there is none, and the name of the icon 
sprite in the variable Sprites* The program 
then decodes the icon number, exiting if it is 
icon number four, but otherwise printing its 
name and number. 
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AN ICON SELECTOR SHELL 


Obviously in your own programs you may 
want to perform some other processing in 
the main polling loop, and all that is required 
is that you check the mouse state regularly, 
and call FNbutton_pressed if necessary. 
Similarly, it is easy to make the icons 
respond to buttons other than Select. 
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REM 

REM Program 
REM Version 
REM Author 


> ScrButton 
Screen button shell 
A 1.00 

Mike McNamara 


REM RISC User October 1989 

REM Program Subject to Copyright 


FROCinit 

REM Demo Program 

FOR icon%»l TO Number% 

PROCplaceJoutton(icon%) 

NEXT icon% 

*POINTER 1 
REPEAT 
OFF 
MOUSE 

IF mb%=4 THEN 

Numbe r_Pre ssed%-FNbutt on_p re s s e d{m 


x%, my %) 

190 CASE Number^preased% OF 


200 WHEN 4: END 
210 OTHERWISE 

220 PRINTTAB{1,1);Sprite$,Number_press 


edl 


230 ENDCASE 
240 ENDIF 
250 UNTIL FALSE 
260 END 
270 » 

280 * I--- 

290 REM Button handling procedures 
300 DEF PROCplace_button(n%) 

310 P ROCget_bu11 on_in fo(n %) 

320 PROCdecodedetalls(Name$,x%,y%,bnu 
mber%) 

330 PROCplotbutton[Name$,x%,y%) 

340 ENDPROC 
350 : 

360 DEF PROCget_button_info(N% J 
370 ButtQns_Left$-*Button$ 

380 FOR button%=0 TO Number l 
390 But ton_In fo $=LEFT $(Butt 0 ns_Le ft $, I 
NSTR(Buttons_Left$,"\")-1) 

400 Buttons_Left$“MIDS{Buttons_Left$, L 
EN(Button_Info$)+2) 

410 IF VAL f RIGHT $ (Button_Info $, LEN {But 
ton_Info$)-INSTR(Button Info$, ) )=N% 
THEN button%=*Number% 


420 NEXT button* 

430 ENDPROC 
440 : 

450 DEF PROCdecode_details(RETURN Name 
$,RETURN x%,RETURN y%, RETURN bnumber%) 
460 NameS-LEFT$ {Button_Info$, INSTR (But 
ton InfoS,":")-1) 

470 xy$=LEFT${Button_Info$,INSTR(Butto 
n_I nfo$,*;")-!) 

4 80 xyS~MID$(xy$,INSTR(xy$, 

490 x%-VAL(LEFT$Uy$,INSTR(xy$,","))) 
500 y%-VAL(MID$(xyS,INSTR(xy$,", ")U)) 
510 bnumber%=VAL(MID$(Buttonlnf o$,INS 
TR{Button_Info$, 

520 ENDPROC 
530 : 

540 DEF PRQCplot_button[N$,x% # y%) 

550 PRQCsinfo(N$,scale*,eol%) 

560 SYS ,r OS_SpriteOp f, / 5234, ap%,ptr%, x% 
,y%,8,scale*, col% 

570 ENDPROC 
580 : 

590 DEF PROCsinfo(NS,scale*,col%) 

600 SYS ?, OS_SpriteOp , * # Sli8,sp%,N$ TO , 

,ptr% 

610 smode*-ptr%!40 
620 IF ptr%!32=44 THEN 
630 palptr%-0 
640 ELSE 

650 FOR F%-0 TO 56 STEP 8 
660 pal%!(F%/2)-ptr%I(F*+44) 

670 NEXT 

680 palptr%-pal% 

690 ENDIF 

700 SYS "OS_ReadMode Variable ", ~1,11 TO 
, ,A% :!scale*-A%+l 

710 SYS "OS_ReadModeVariable",-l, 12 TO 
,, A%:scale!S 4-A%+l 

720 SYS 1, Q$_ReadModeVariable", smode!,l 

1 TO ,,A4:scale%!fl“A%+l 

730 SYS "OSReadModeVariable",smode%,l 

2 TO r , A%:seale%!12-A%+1 

740 SYS "ColourTransSelectTable",smod 
e%,palptr%,-1,-l,col% 

750 ENDPROC 
760 s 

770 DEF FNbutton_pressedfMOUX%,MOUY%) 
780 Buttons_Left$ ta Button$ 

790 FOR buttOn%-0 TO Number! 

800 Button_Info$-LEFT$(ButtonsJjeftS, I 
N S TR(Butt ons_Le ft$,"\ B )-1) 

810 PROCdecode_det ails [Name $,x %,y %,bnu 
mber!) 

320 IF NameSc*"" THEN 
B30 SYS "OS^SpriteOp", *128,sp%,Name$ T 
0 ,,,width%,height% 
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I 


840 PROChit [Name$,x% , y%,MOUX%,M0UY%, bn 
uirber%, width %, height %} 

650 ENDIF 

860 Buttons_Left $=MID$(Buttons_Left$,L 
EN (Button^In fo$)+2) 

870 IF hit % THEN button%=Number% 

880 NEXT button% 

890 hitFALSE 

900 =Nuniber_Pressed% 

910 : 

920 DEF FROChit (N$, X%, Y%,MX%,MY%, BN%, W 
% , H%) 

930 PROCsinfo{NS,scaie%,col%) 

940 W%-W%*!scale%/scale%!8 
950 H%=H%*scale%14/scale%!12 
960 SYS n OS_ReadModeVariable ,t , -1, 4 TO 
, , A%:W%-W%«A% 

970 SYS "OSReadModeVariable",-1, 5 TO 
,, A% : H%~H%«A% 

980 IF MX%>X% AND MY%>Y% THEN 
990 IF MX%<X%+W% AND MY%<Y%+H% THEN 
1000 Number_pressed%-BN% 

1010 Sprite$=N$ 

1020 SOUND 1,“15,120*1 
1030 hit%“TRUE 
1040 REPEAT 



SERIES 

Introduces: 
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PROFE33IONAL 

PAINT 

the compatible graphics program for 
the Archimedes 

abe Id load EVERY graphs tomai ^afciu Aitijsaml MwiR 
SLCOOftS al Archfr>eces h ss r dware Lpjadt.™ 

txrntf (iwara lor siardvti coicu pnniefs m*. □nd’aiuiriKi 
Vnu vtsfBtrfi £56 colons and fi aittrs 
IJy SPRITE oftenfeda^Jhica VECTOR torus 
anB^cdDJ slatislcsana liters 
vary laililrai! dmsnsimial par [ 
r&alliHYs magrtter 
crire helpt&Jilti 

wary 6HKy fcj Lfitf? 



[_ GMA mbH, 38 Upper WelfheacJ&, Limekilns. FIFE:. Scolland 


1050 MOUSE holdx%,holdy%,holdb% 

1060 UNTIL holdb%-0 
1070 ENDIF 
1080 ENDIF 
1090 ENDPROC 
1100 : 

1110 DEF PROCinit 

1120 fileS- w ICONS":mode%-l2 

1130 MODE mode3 

1140 Nuinber^pressedl^O 

1150 Sprites-"" 

1160 Number%=*7 

1170 Button$-"\file_f ff:2 0 0, 2 0 0;1\flopp 
ydisc; 4 00, 400;2\error: 6 0 0 ,10 0;3\switche r 
:1100, 50;4\directoryi 900, 800;5\network:9 
00,200;6\harddisc:500,900;7\" 

1180 hit%-FALSE 
1190 X%“OPENIN fileS 
1200 L%=EXT#X%:CLOSEfX% 

1210 DIM pal% 63, col% 15, scaled 15, s 
p% L%+4:I sp%-L%+4 

1220 sp% T8-16:SYS "OS SpriteOp", & 109,sp 

% 

1230 SYS "OS_SpriteOp ,, ,SlOA,sp%, fileS 
1240 ENDPROC |&j 


TNBCMIICAIL IMTO1 

Due to internal promotion 
an exciting opportunity has arisen for a 
Tfechnical Editor to work on BEEBUG and its 
sister magazine RISC User. 

The work is hard and demanding, but at the same 
time extremely varied and interesting, with the 
Technical Editor playing a major role in producing 
both RISC User and BEEBUG. 

The successful candidate will be fully conversant 
with the Archimedes and the BBC micro range, 
and will have experience in programming both in 
Basic and machine code. 

He/she wid also have good knowledge of English 
and be capable of writing reviews and articles 
and editing the work of others. 

If you believe you are the right person for the job, 
then please send a full CV to: 

The Personnel Manager, BEEBUG 
117 Hatfield Road St, Albans, 

Herts AL1 4JS. 
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CLARES’ ARMADE US 


Stuart Bell takes a look at this new sound sampling package from Clares. 


Armadeus (Wolfgang Amadeus Mozart - 
get it?) is the name given by Clares both to 
the software and the sound sampler podule 
which together form the Armadeus package. 
The software will operate with other 
hardware, namely the Armadillo A448 and 
A448b boards, the Wild Vision 1208, and the 
Unllab Computer interface - the latter being 
interfaced using the Acorn I/O podule - but 
for this review, the podule and software were 
tested in tandem. 



The Armadeus podule (by Wild Vision) 


A sound sampler captures analogue 
signals - such as music from a hi-fi 
system - measures the waveform many 
times a second {at what is termed the 
sampling rate) and converts that 
measurement into a digital value which 
may then be stored in the host computer's 
memory. Playback requires a reversal of 
that process, with the digital values 
stored in memory being converted into an 
analogue waveform which is sent to the 
Arc's internal speaker, headphone socket, 
or, in the case of Armadeus , to the 'line 
out 3 on the podule. 

The performance of such samplers is 
measured by two criteria. Firstly, the 
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resolution of the conversion. This is the 
number of discrete levels which can be 
detected by the sampler. The Armadeus 
podule, like most others, works to 8-bit 
resolution, giving 256 levels. The higher 
the resolution, the lower the noise 
introduced during reply as a result of the 
discrete levels used during the sampling, 
but also the higher the cost. The second 
parameter is the sampling rate - the 
number of samples taken every second. 
For a rate of n samples a second, 
frequencies up to n/2 Hz can be sampled. 
Furthermore, frequencies above this level 
must be supressed, otherwise they will add 
disastrous distortion to the signal. Clearly, 
the higher the sampling rate the better, but 
also the more memory required. 
Additionally of course, the hardware 
imposes limits on both parameters, 

THE HARDWARE 

The Armadeus podule (bearing a Wild 
Vision copyright notice) is half width and 
provides external connections for line in', 
‘mic in' and line out’. The board is well- 
made, neatly laid out, and can be fitted in a 
few minutes following the instructions 
provided - assuming, of course, that you 
have a backplane installed. A blanking 
plate is supplied should you need this, as 
are two spacers which correct a problem 
with the backplane positioning on the 300 
series. Connections are by 'phono' (line) 
and standard quarter-inch jack sockets. 
The board's input gain may be adjusted 
under software control, thus allowing a 
range of input levels to be sampled 
properly - a feature not found on many 
sound samplers. Another facility offered by 
the hardware is a digital to analogue 
output. This allows sounds to be replayed 
through the podule at a higher quality than 
could be obtained using the Internal sound 
system. 
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i 


THE SOFTWARE 

ff the system only allowed the re~ playing 
of recorded signals, then its vafue would be 
very limited. However, the Armadeus 
software provides a very powerful suite of 
tools with which to analyse, modify and store 
sampled sounds. 

Once a sound - such as a note from a 
musical instrument, spoken words, or even 
a line of a song - has been sampled, its 
waveform may be displayed and then 
modified. Sections may be marked, moved, 
repeated, deleted, faded in or out, or 
changed in pitch. This is accomplished 
using an oscilloscope-llke display which 
allows the horizontal scale to be increased 
progressively so that the most detailed part 
of the waveform may be examined. Echo 
may be added, and looping points 
indicated, to control the repetition of parts 
of the sound. Samples may be 
concatenated or overlaid by an interface to 
the fite system which fully meets RISC OS 
standards - for example to load a file, its 
icon is dragged from a directory viewer into 
the main Armadeus window. Indeed, the 
whole package, from first being installed on 
the Desktop icon bar, follows the RISC OS 
standard Wimp environment, and all 
options are made available through 
hierarchical menus. 

A couple of very nice features are the 
VU meter and the FFT (Fast Fourier 
Transform) analysis. The first one of these 
provides a reaf time image of the sound as 
it is sampled or replayed, and is much the 
same as would be seen if the signal was 
examined using an oscilloscope. The FFT 
on the other hand uses a mathematical 
technique to convert the sampled image 
into a frequency versus amplitude display. 
This allows you to see how the tones 
making up the sound are distributed 
through the frequency spectrum, and as 
such, performs much the same function as 
a spectrum analyser. Neither of these 


features work within the Desktop 
environment. Instead, the screen mode is 
changed and the display produced in real 
time. However, as soon as the operation is 
complete you are returned to the Desktop 
exactly where you left off. 

DOCUMENTATION 

The facilities offered by Armadeus are 
described in a well-produced A5-size spiral 
bound manual of 70 pages which combines 
the usually separate tutorial and reference 
sections by suggesting exercises to be 
followed after new material Is introduced. 
These exercises make use of the two discs 
full of ready-sampled sounds which are 
supplied with the program disc. None of the 
discs is copy-protected, so hard-disc users 
should have no problems. Three cheers for 
Clares' trusting attitude: let's hope Arc users 
don't abuse it 

UNDER TEST 

The software does all that the manual 
claims* and provides a very easily used 
range of tools with some very Impressive 
displays. Connecting my CD-player playing 
a Chris de Burgh album revealed that a 
sampling rate of about 15kHz produces 
adequate quality output, whereas 10kHz 
made the artist sound as if he had a lisp! 
My 1Mbyte 310 allowed a sound buffer of 
about 500Kbyte (the package includes an 
Application to maximise this), allowing just 
over 30 seconds* recording at 15KHz, 
Attempts to playback through the 
Armadeus 'line out* and a hi-fi system 
revealed the most annoying aspect of the 
whole system. Whereas internal output can 
be achieved by hitting one function key, 
external output requires a menu selection 
and confirmation every time. Since the 
manual goes into raptures about the 
superb quality obtainable from the 
Armadeus output, when one Is repeatedly 
testing minor modifications to a sample this 
becomes increasingly exasperating. 
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APPLICATIONS 

What* you may ask* does one do with the 
samples thus obtained and manipulated? 
The package provides a utility to save a 
sound as a module* so that it can, for 
example* be played whenever Control-G 
(normally the 'beir sound) is typed* or* more 
usefully, used in applications such as 
‘Maestro*. A Readme file on the systems disc 
warns users that 
samples to be 
made into modules 
should be re¬ 
sampled at 48usec 
(just over 20kHz), 
to avoid problems 
of pitch. I did this* 
but still ended up 
with Chris de Burgh 
sometimes 
sounding just right, 
but at others as a 
barely audible boy 
soprano* 
depending on how 
the same module 
was being used. \ 
suspect that the 
presence of the 
Readme fiie indicates a problem which has 
not really been fully solved. I think that 
Clares really must make the process of 
producing sound modules which play at the 
correct pitch much less of a trial-and-error 
process. 


medical physicists will find its ability to act 
as a storage oscilloscope at audio 
frequencies, with level-measuring and 
frequency-analysts tools, most useful* and 
it may find a ‘niche-market' in those areas. 
Such users, however, will almost certainly 
require better hardware documentation 
(none is currently provided), and some low- 
level driving software* if they are to 
produce specialised 
applications for the 
Armadeus poduie. 

The manual con¬ 
cludes its answer to 
‘What can you use 
It for?* with ‘most 
importantly it is just 
great fun. 1 That is 
indisputable. if 
Glares address the 
issues of the ease 
of obtaining ex¬ 
ternal output, and 
the pitch problems 
with sound mod¬ 
ules, then the 
Armadeus package 
will be an excellent 
mono-phonic high-speed 8-&bit sound 
sampler* driven by a superb piece of 
software. However, unless you have a 
specific application in mind, then at £200, it 
may seem rather self-indulgent for some 
‘great fun 1 . 



Displaying a sampled sound 


The answer to the question 'What do 
you use a sound sampler package for?' is 
fundamental to the success of this product, 
Armadeus is not realty an end-user's 
product, unlike a word-processor for 
instance. It is a ‘'means to an end” rather 
than an end in itself. For those wishing to 
generate sound effects for use in programs 
- especially games - or musical tones for 
use in music packages, then Armadeus will 
meet their requirements most effectively. 
Some scientists, educationalists* or 


Product 

Armadeus sound sampler 

Supplier 

Clares Micro Supplies, 

93 Middfewich Road, 
Rudheorth, Northwich, 
Cheshire CW9 7DA. 

Tel. (0606)43512 

Price 

£79.95 (Software only) 
£149.95 (Hardware only) 
£199.95 (Both together) 

(All prices Inc. VAT) 
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Acorn manuals: 


Bask: User Guide (Arthur) 


RISC OS User Guide 


RISC OS Basic Manual 


Fast ARM Code searching 


Mouse controlled 


Runs from the Desktop 


Keyword entry with 


selectable logic 


Fully customisable 


Extensive on-screen help 


Hard copy options 


Please send me: 

ArcScan II Disc and manual Code 0109A Q ArcScan Upgrade Code 0110A U 

Price £14.95 members (£24.95 non-members) Price £7.95 members (£17.95 non-members) 

For upgrade, please state month of purchase of RU Special Disc . 

Name___ 

Add ness __ Cost £__ 

_ Postage (£0.60) £_ 

Membership No_____ Total £ 

1 enclose a cheque for £__ ■ OK please debit my Access, Visa or Connect account, Card 

No_/_/___/ Expiry_ j __ Signed,_ __ _ 

Return to BEE BUG Lid, 117 Halfield Road, St Albans, Horts A LI 4JS. Telephone (0727) 40303. 


Programmer's Reference Manual (Arthur) 


ArcScan Features 


RISC OS Programmer's Reference Manual 


Fully 

Customisable 

A user-defined 
custom file 
allows easy 
customisation 
for other data. 


For example: 

1. ff you need to know about Obey Fites, enter the words 'obey\ tiles' and click on the AND logic. 
All finds in RISC User will be instantly displayed. You can now calI up the Acorn Manuals indexes and 
repeat the search to get further references. 

2. To find the "SWIname" for SWt &400D4, select the new Programmers Reference Manual from 
the menu, enter and quote *SWt &40QD4", and the answer appears, complete with page references 


Use ArcScan It's rapid keyword searches to find all the references you need! 


ArcScan II contains the following 
databases: 


RISC User Volumes 1 ■ 2 
BEEBUG Volumes 1 • 8 
The Indexes to the following Archimedes 


ArcScan II 


ARCSCAN 


V 


Tvnfi 


flreScan 


Now includes indexes to Archimedes manuals 
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ASSEMBLER WORKSHOP 


David Spencer and Lee Calcraft kick off a new series. 


Assembler Workshop is a new occasional 
series which will be devoted entirely to 
programming in ARM assembler We will aim 
to cover a wide variety of material for both 
the expert and the relative beginner. This 
month we kick off with a number of hints and 
tips, 

SIMPLE DEBUGGING 

It is probably true to say that when writing 
machine code routines, at least as much 
time will be spent in debugging the final code 
as In structuring and writing it in the first 
place - so some notes on debugging may not 
come amiss. 

Firstly it Is often much more effective to 
debug your code as you go along, since 
once you have put a number of interrelated 
segments together it will usually be much 
harder to isolate a bug. Often, very simple 
tests can be used. For example, a short 
routine is given below which displays in 
both decimal and hex the contents of 
register RO. The routine has the merit of 
preserving all registers, so that it can be 
used invisibly. 

To check the contents of R12 (say), just 
use the two instructions: 

MOV RQ,R12:BL debug 

Sometimes you just need to know how far 
through a routine your code has reached 
before it crashes (especially if the crash is a 
fatal error). This is easily achieved by 
inserting instructions such as: 

SWI 256+7 

to generate a beep, or 

swi sse+AScr*") 
to place an asterisk on the screen. 

For more serious and intensive 
debugging, you can't beat the Single- 
Stepper published in this and last month's 
RISC User. 

10 REM >Debug3 

20 REM Simple debugging aid 
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30 

REM 

by Lee Calcraft 

40 

t 


50 

DIM code% S10G 

60 

PKOCassemble 

70 

CALL test 

80 

END 


90 

; 


100 

DEEP ROCa s semb1e 

110 

FOR pass-0 TO 2 STEP 2 

120 

F%=code% 

130 

{OPT pass 

140 

.test 


150 

STMFD 

R13!,{R14} 

160 

MOV 

R0,#410000 

170 

BL 

debug 

180 

LDMFD 

R13!,{PC} 

190 

\ - 


200 

\ Print 

cents of R0 as dec 6 hex 

210 

.debug 


220 

STMFD 

R13!,(R0-R3,R14) 

230 

ADR 

Rl,debugspace 

240 

MOV 

R3,R0 

250 

MOV 

R2,#S20 

260 

SWI 

"OS Convertlnteger#" 

270 

MOV 

R0,132 

260 

STRB 

R0, [Ha],11 

290 

STRB 

R0,[Rl],#1 

300 

MOV 

R0,§ASC ("S") 

310 

STRB 

R0, [Rl),n 

320 

MOV 

R0,R3 

330 

SWI 

"0S_ConvertHex8" 

340 

ADR 

R0,debugspace 

350 

SWI 

"OS_WriteO" 

360 

SWI 

"OS NewLine" 

370 

LDMFD 

R13!,[R0-R3,R15) 

380 

.debugspace 

390 

EQU5 

STRINGS(520,CHR$0) 

400 

V -- 


410 

]NEXT 


420 

ENDPROC 



ERROR FREE SWI CALLS 

A very useful feature of RISC OS (and 
Arthur) is that aft SWI calls can be made to 
return to the caller If an error occurs, rather 
than 'crashing out*. To do this, you simply set 
bit 17 of the SWI number (add &2000Q), or if 
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The name is used prefix it with an 'X' (for 
example "XOS_Byte M instead of w OS_Byte\ 
The use of ‘error free 1 SWIs is very useful for 
error handling, and is essential when writing 
utilities and modules, as the error handler 
must not be called in these circumstances. 

In fact, from the point of view of the 
routine Implementing the SWI, the situation 
is reversed. All SWI calls return with the 
overflow set if they wish to generate an error, 
and clear otherwise. However If the non-X 
form of the SWI is used, RISC OS intercepts 
the error result, and generates an actual 
error. In the case of an error occuring, RO will 
point to the error number followed by the 
error string. We will return to this is a future 
Assembler Workshop when we look at 
writing modules. 

OVERFLOW ANTICS 

As just stated, the overflow flag is used 
by RISC OS as an error indicator with certain 
calls. Normally, RISC OS ensures that when 
a routine is called the overflow flag is clear 
(the exception being certain vector 
handlers), and therefore the flag is ready for 
an error-free exit. Unfortunately, many 
arithmetic instructions potentially alter the 
value of the overflow flag, accidentally 
signalling an error. The easiest way to 
prevent this is to always restore the flags on 
exit from a routine whenever the routine 
doesn't return an error flag. This Is done 
using: 

MOVS PC,R14 

when the return link has not been saved, or 

LDMFD R13!,{PC)* 

when the link has been stacked. Note the 
addition of the *S' orto restore the flags. 

WATCH OUT DCW 

The DCW instruction is present in both 
Basic's assembler (where EQUW is a 
synonym) and In AASM (Acorn's standalone 
assembler). Its purpose Is to store a sixteen 
bit value in two successive bytes of memory, 
low byte first {so-called little endien form). 
However, there is a subtle difference 
between Basic and AASM. Basic will place 


the value in the location pointed to by the 
current instruction pointer, and the following 
location. AASM on the other hand will align 
the instruction pointer to a sixteen-bit 
boundary first. To mimic the Basic 
assembler’s behaviour under AASM, the 
following macro can be used: 

MACRO 

NDCW $word 

= Sword :MOD: 256 

Sword / 256 

MEND 

This defines the Instruction NDCW (Non- 
aligned DCW) to mimic Basic's DCW. In 
other words, the argument is stored In two 
consecutive locations without any pre¬ 
alignment 

SIGNED ARITHMETIC 

The ARM's arithmetic instructions {ADD, 
SUB, ADC etc.) can all work with both 
unsigned and signed numbers. Unsigned 
values stored in a single 32-bit word are in 
the range 0 to 2*M, and are stored as pure 
binary. Signed numbers on the other hand 
are in the range -2 ai to 2 3T -1, Positive 
numbers, including zero, are stored in pure 
binary, while negative numbers are stored in 
so-called two's complement form. To find the 
value stored for a negative number, take its 
positive equivalent, invert all the bits (ones 
become zeroes and vice versa), and add 
one to the result. As an example, consider 
representing -6 in a 4-bit number. 

Plus 6 would be stored as 0110 

Inverting the bits gives 1001 

Adding one leaves 1010 

Adding one is necessary to remove the 
anomaly of +0 and -0 being different, which 
causes problems with arithmetic. This also 
explains why the range of possible values is 
not symmetrical around zero. 

A bit of experimentation on paper should 
convince you that the operations of addition 
and subtraction are identical whether the 
arguments are signed or unsigned, and the 
result will be in the correct form. Of course, 
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you can't have one argument signed, and 
the other unsigned. It should also be 
immediately obvious that all positive 
numbers have their top bit clear, and 
negative numbers the top bit set. 
Furthermore, negating a number is done in 
the same way as creating a negative number 
from its positive equivalent. If the ARM 
register RO holds a signed value, it can be 
negated using: 

MVN R0,R0 

ADD R0,R0,#1 

Similarly, to obtain the absolute value of a 
number in RO use: 

TST R0,#l«31 

MVNNE RO, RO 

ADDNE RO,RO,#1 

One difference with signed arithmetic is 
that the carry flag no longer gives an 
indication of an overflow condition. For 
example, adding two negative numbers will 
always produce a carry, although this does 
not necessarily mean an overflow has 
occurred. To overcome this, the ARM has a 
separate Overflow flag which is defined to be 
the Exclusive-OR of the actual carry, and the 
carry out of bit 30. This flag then gives a true 
overflow indication, being set if the signed 
result of a calculation is too big. 

The ARM multiply (MUL) and multiply and 
accumulate (MLA) Instructions will also work 
with both signed and unsigned arguments. 
However, this is only the case when 
multiplying two 16-bit arguments to give a 
32-bit result, and it should be noted that 
neither MUL or MLA set the overflow or carry 
flags to a useful value. 

The operation of dividing a number by 
two by shifting it right can also be applied to 
signed numbers, but rather than replacing 
the top bit with a zero, it is necessary to 
replicate the previous top bit. This is exactly 
what the ASR (Arithmetic Shift Right) shift 
operation does, while LSR (Logical Shift 
Right) shifts in zeros. Hence: 

MOV RO,RO,ASR #1 
will halve the value in RO, while: 


MOV R0,R0,LSR #1 

will only work correctly for positive signed 
numbers (or unsigned numbers). 

Multiplying a number by two by shifting it 
left will also work, but care needs to be 
taken, as if an overflow occurs this will 
manifest itself as a change of the sign of the 
number. 

A final operation that is sometimes 
necessary on a signed number is the 
process of sign extension. This operation is 
used to make a number longer (in the 
sense of being stored in more bits). For 
example, suppose that you had an 
analogue to digital converter on a podule 
which returned 8-bit signed numbers, and 
you wanted to store these as 32-bit values. 
It is not enough merely to zero the top 
twenty-four bits (as LDRB does 
automatically), because the sign will be 
incorrect. Instead, what is needed is to 
replicate the top bit of the original number 
into all of the unused bits. To convert the 8 
bits in 32 the following code could be used: 

MOV RO,RO,ASL #32-8 

MOV RO,RO,ASR #32-8 

This works by moving the original eight bits 
up to the top of the word, and then down 
again, using the fact that ASR will 
automatically replicate the sign. 

TYPING AASM FILES 

When using AASM, all assembled code is 
saved with a load and execution address 
rather than a filetype. This can be annoying 
when assembling a utility or module as the 
filetype must be set before the code can be 
tested. However, AASM can be made to 
stamp a file using the LEADR directive, for 
example: 

LEADR &FFFFFA00 

where the filetype is given in the 4th to 6th 
digits - FFA for a module, FFC for a utility, 
etc. This works by exploiting the way in 
which RISC OS stores filetypes and date 
stamps in the fields used for the load and 
execution addresses. 
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HARDWARE AND 
SOFTWARE EXPANSION FOR 
THE ACORN ARCHIMEDES 
COMPUTER SYSTEM 


EXPANSION CARDS 

1EEE488 INTERFACE a full implementation of the standard for automatic 
test and measurement systems 

16 BIT PARALLEL I/O two 16 bit input or output ports with handshake lines 
for digital control applications 

DUAL RS423 SERIAL INTERFACE for communicating with two additional 
RS423 or RS232 devices eg printers, plotters, instruments, etc. 

12 BIT ADC an analogue to digital converter capable of up to 166000 
samples per second 

All the above high performance expansion cards are supplied with high 
level software for ease of use and a comprehensive user guide 

TERMULATOR For Archimedes Computers VT52. VT102, VT220 and 
Tektronix 4010 terminal emulations 

Termulator. a trademark of Acorn Computers Limited, is applied to this product under licence 
from Acorn Computers Limited 

HARD DISC UPGRADES Large capacity internal and external hard disc 
upgrades for Archimedes 400 Series Computers 

COMPLETE SYSTEMS All the standard models plus Archimedes 410 
Computers fitted with the following options: 

1 or 2 Mbytes of additional memory 
Large capacity internal hard disc 

LASER PRINTER - £1298 AEG Olympia Laserstar 6 - the ideal printer for 
Acorn Desktop Publisher 

L5 Mbytes of memory for full page 300 x 300 dpi raster or 
vector graphics 

HP LaserJet + and Diablo 630 emulations as standard 
Optional Postscript emulation 

Officially appointed Acorn Scientific Dealer 

Intelligent Interfaces Ltd 

43b Wood Street 

Stratford-upon-Avon Tel: 0789 415875 

Warwickshire Fax: 0789 299600 

CV37 6JQ Telex: 312242 MIDTLX G 
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INSTIGATOR INVESTIGATED 


entry of complex pathnames by allowing 
simple names to be tagged to directories - 
again a very powerful feature. Instigator's disc 
sector editor will edit a wide range of formats, 
including PC discs, and has facilities to 
search the disc, and to transfer sectors 
between memory and the disc. 

Miscellaneous commands are provided to 
list a Basic program from a file, control the 
RISC OS hourglass, issue SW1 calls, and 
display lists of available SWIs. Finally, the 
documentation hints that future versions of 
Instigator will include extra features, and if 
Dabs follow their normal policy then 
upgrades will be available at little or no cost 
to registered users. 

DEMONSTRATION DISC 

As well as the program disc, instigator Is 
supplied with a demo disc which contains 
among other things a rolling demo of all the 
features. This lasts for about half an hour, and 
while you are only likely to use it once, it does 
show the new user exactly what instigator is 
capable of. There are also separate 
demonstration programs to show the use of 
new modes, and other instigator features. 

THE RISC OS INTERFACE 

One of the problems with implementing 
utilities as star commands Is that you have to 
leave the friendliness of the Desktop to issue 
them, and this can prove confusing to 
beginners. To get around this, the instigator 
disc includes a Desktop application which can 
be installed on the iconbar. Clicking on the 
icon then brings up a window containing ail the 
Instigator commands. Subsequently, clicking 
on a command will execute it If no parameters 
are needed, otherwise it will pop up a further 
window asking for the parameters, and give 
you the option to execute the command or to 
abort *t. This might sound long-winded, but it 
does provide an interface to instigator from 
within the Desktop. 

DOCUMENTATION 

instigator is supplied with a 128 page A5 
wire bound manual. This starts off with an 
overview of the features offered, and details of 


installing and running Instigator, The individual 
commands are then described, not in 
alphabetical order, but rather split into sections 
according to their function. The descriptions 
are adequate in most cases, but it is not 
always possible to describe all the details. For 
example, the section on defining new modes 
makes no attempt to describe the necessary 
data, but instead refers you to the VIDC data 
sheet which is available from Acorn, 

My only moan about the manual is that it 
has no real index, although the contents 
section Is fairly comprehensive. This can 
make It difficult to locate the entry for a 
particular command, especially because of 
the ordering, and the fact that the manual is 
written in book style, rather than having one 
command per page. 

CONCLUSION 

When I first looked at instigator, my 
immediate impression of the package was 
that a lot of its features were little more than 
gimmicks, and I still doubt the usefulness of 
some of them. The manual suggests that a 
number of features, such as the window 
system, can be incorporated into your own 
programs. I am always wary of this, because 
it restricts the program for use on systems 
which have that particular utility package. 
However, using the package for a few 
minutes soon convinced me that it provides 
a wealth of very useful features, including 
just about everything offered by other toolkit 
packages. In particular, the memory editor 
and disassembler are vital to most 
programmers. When you consider that at 
£50 instigator is no dearer than its closest 
competition, notably Clares' Toolkit Plus, 
then it seems even more attractive. To sum 
up, if you need a toolkit then i can highly 
recommend instigator. 
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PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 

Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3, It is fully multi-tasking and inulti-windo wing, so you cart work on many documents at once and instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 

Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 

For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon, 
PipeDream 3 is for all Archimedes computers with RISC OS and l Mbyte of RAM. 

PipeDream 3 costs £147,00 +VAT. 


Major features include: 

* many documents loaded at once 

* in tuitive RISC OS user i n tc rface 

* displaying and printing 
of pictures within teat 

■ built-in 93,003 word 
spelling checker 

* file compatibility with 
PC in Z88 PipeDream and 
BBC View Professional 

■ background recalculation 

* keystroke compatibility 
with ZS& Ac PC BpeDieam 

* Z88 filing system 


automatic loading of VIEW, 

VtewSheel, Lotus, First Word 

Plus, Tab and CSV files 

automatic saving of VIEW, 

Lotus, Acorn DTP format. Tab 

and CSV files 

multi-field sorting 

use of all available fonts 

62 spreadsheet functions 

external references for 3-D 

modelling 

macro file recorder 

slot protection 


. For a. free brochure, complete and return i bis coupon . 
I PipeDream 1 (j View Professional □ 

j Name _ _ ___ | 

[Address_ _ ___ , 


| Cohort Software, Rroadway House,M9-l5l Si. Neois] 
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I 


by Mike Ironmonger 


This month we add the second and final 
part of the Desktop Diary program, which 
aliows entries to be made and edited, and 
saved to fiie for later recall. For a detailed 
account of how to use the complete program 
you should refer to last month's RISC User 
(Volume 2 Issue 9), 

To add this month's coding to that for last 
month, type it in and save it under a suitable 
name. Then load part 1 of the program and 
use the APPEND command to add the rest. 
The whole program should be saved with the 
name IRunlmage in the SDiary directory as 
described previously. 

The Diary can be Installed by double 
clicking on its Icon in a directory viewer, 
while a single click on the menu bar will 
display the calendar for the current month, 
ready for entering data. Alternatively if you 
have already created and saved a diary file, 
then you should load this by dragging its icon 
over the Diary icon on the menu bar, 

TECHNICAL DETAILS 

Each diary entry requires 168 bytes of 
memory. The first three bytes hold the 
combined month and year, the next byte the 
day, and the remaining 164 bytes four lines 
of 41 characters. The maximum number of 
entries is set by the variable max_notes% in 
line 3280, and the command WimpSEot in the 
IRun file. This maximum is currently set to 
270 entries, which requires 64K, If this is 
insufficient, change the WimpSlot command 
and adjust max_notes% accordingly - each 
8K of memory gives another 48 entries. 

Because there may be many hundreds of 
entries, three machine code routines are 
employed so that operations on the entries 
occur very quickly. find_entry is passed a date, 
and returns the address of the entry for that 
date, insert_entry is passed the address of an 
entry and creates a gap at which to insert the 
new entry, while delete_entry does just that on 
being passed the address of an entry. 

The program may produce any of three 
error messages. The first occurs if the 
number of diary entries has reached the 
maximum set, and you click on an un¬ 
highlighted date. The second happens if you 
try to load a diary file with more entries than 


the current maximum. The last error can 
occur when attempting to merge a diary file. 
If a new entry would cause the maximum 
number of entries to be exceeded, then this 
is flagged, but the rest of the file is read in 
and existing entries overwritten, but ail 
completely new entries will be ignored. 



170 when 7 : PRQCdrag_done 
180 WHEN 8 : PROCkeypress { !block*,bio 
ck%!4,block*3 8,block*[24) 

270 IF W*Ow_diary% THEN 

280 date* (FNget_note_num (W%)) --1 

290 B*=FNatfdr (W%) 

300 IF del* OR (B%?4=13 AND B*745=13 A 
ND 3*786=13 AND B%?127=13) THEN 
310 CALL deleteentry 
320 FRQCnewmonth(0):FROCupdate note s{ 
FALSE) 

330 ENDIF 
340 ENDIF 

430 WHEN 16,64 ; PRGCdrag click 

470 DEFPROCdragdone 

480 SYS "Wimp_GetPointerInfoblock* 

490 block*!20=64:block*!32=0 

500 block*!36=1;block%3 4Q=block%[12 

510 block*I44=block%!16 

520 block*!48=!block* 

530 block*3 52=block%!4 
540 block*!56-!next-!first 
550 block*!6Q-&FEF 
560 $(block*+64)-FNleaf{$filename*) 
570 SYS "Wimp_SendMessage , \17,block%+2 
0 f block*!12,block*!16 
580 ENDPROC 


t1 
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590 : 

600 DEFPROCkey_press(W%,i*,x*,C*) 

610 CASE C% OF 

620 WHEN 13 : IF W*=w_save% PROCquick_ 
save ELSE PROCcaret (W*, l%- (I%<3), 0) 

630 WHEN 30 : PROCcaret(W*,0,0) 

640 WHEN £ 1 BE rPROCcaret(W% ,I%-(I*<3),X*) 
650 WHEN 61BF:PROCcaret(w%, I %+ fI%>0>,X%) 
660 OTHERWISE SYS M Wimp_ProcessKey t, f C% 
670 ENDCASE 
680 ENDPROC 
690 I 

760 WHEN 2 : PRQCprint_entries (B*J 

780 OTHERWISE : CASE A* OF 

790 WHEN 0 : PROCclearentry(mw*) 

BOO WHEN 1 : PROCclosewindow(mw% f TRUE 
):5tay%”FAL$E 

810 WHEN 2 : FROCprint_entries(FNaddr( 
mw%)) 

820 ENDCASE 

900 WHEN 2 : PROCsave_notes[FNgetjiame 
(block%+44)) 

910 WHEN 3,5 : IF block*!12=0 AND bloc 
k*!40-&FEF FROCloadmerge(block*!20,FNge 
tname(block%+44)) 

980 WHEN w_save% : IF I*=i_ok% PROCqui 
ck_save 

1020 OTHERWISE FROCdateselected((month 
%«8) +I%-3) 

1120 OTHERWISE : PROCmastermenu("Diary 
note","Clear,Delete,Print,",X%,Y%) 

1160 DEFPROCdragclick 
1170 SYS "WimpGetWindowState",,block%+ 
12 

1180 X%=block%!16:Y%=bloc k%!28 
1190 block*!16=1%:SYS "WimpJSetlconStat 
e 1 ',,block%+12 
1200 block*!16=5 

1210 block*!20+=X%-2:block*!24+=Y%-4 
1220 block*!28+=X%+2:block*!32+=Y%+4 
1230 block*!36=0:block *\ 4 0=0 
1240 block* l 4 4=& 7FFFFFFF 
1250 blOCk*!4B-£7FFFFFFF 
1260 SYS 1 'Wimp_DragBox fl ,,block%+12 
1270 ENDPROC 
1280 : 

1360 A%=! first :X*=8+FNday (y*,m%,l) *64: Y 
*=-152 

1390 B*=FNicon (w diary*,STR?D*,X%, Y%, 44 
,44, S27003009-32*(E%=!USR search)) 

1470 DEFPROCdateselected(E*) 

1480 N*=0‘WHILE N%<4 AND date*(N*)<>E% 


N*+-liENDWHILE 

1490 IF date*(N*)=E% PROCtop(N%,FALSE): 
ENDPROC 

1500 N%=0:WHILE N*<4 AND date*(N*]>0 N* 
+=1: END WHILE 

1510 IF date*(N%)>0 ERROR 1,"Can't open 
any more note windows." 

1520 A*=USR findentry 
1530 IF !A*OE% THEN 

1540 IF !next=!max ERROR 1,"No memory f 
or any more entries," 

1550 CALL insertentry 
1560 !A*=E*;A%!4=13:A*!45=13:A*!86=13: A 
%!127-13 

1570 PROCset_icon_state(w_diaryl, I*, 32,32) 
1580 ENDIF 

1590 PROCtop(N%,TRUE) 

1600 ENDPROC 
1610 ; 

1620 DEFPROCtop(N*,new*) 

1630 P ROCope n_window(w_note %(N%)) 

1640 IF new* date*(N%)=E*:$note_date%(N 
%)=FNdate string(E%):PROCupdatenotes(FA 
LSE) 

1650 PROCcaret(wnote*(N*),0,0) 

1660 ENDPROC 
1670 : 

1680 DEFPROCupdate notes (show!) 

1690 SYS "Wimp GetCaretFosition",,block 
%+36 

1700 FOR D%=0 TO 4:E*=date%(D%) 

1710 IF E*>0 THEN 
1720 !block*=w_note*(D*} 

1730 P%=USR find_entry+4;Y*--44 
1740 FOR I%=0 TO 3 

1750 block*!4=1%:SYS "WimpDeletelcon", 
,block* 

1760 A*=FNind_icon(wnote*(D*),P%,-1,41 
, W ",0,Y%,652,44,£700F101) 

1770 IF show* PROCseticonstate(wnote 
* (D%),1%,0,0} 

1780 Y%-=40:P%+=41;NEXT 
1790 ENDIF 
1800 NEXT 

1810 SYS "Wimp^SetCaretPosition",block* 
!36,block*!40,block*!4 4,block*!4 8,block* 
!52,block*!56 
1820 ENDPROC 
1830 i 

1840 DEFPROCclearentry(W%) 

1850 P*=FNaddr(W%) 

1860 FORI*-0TO3:P%?(I**41+4)=13 
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SILICON VISION 

SOFTWARE FOR THE ARCHIMEDES & BBC 


SolidCAD 


ARC-PCB 






r iV ton mate ID Otaughhnq System tor Architectural design. Interior design, Engineering 
Design and teaching CD/ Alices drawing mpian. front & side elevations and also directly 
■n fri 1 . 11 ides po wed ui zoom & p a t \ options, for ptec rsion draugti fing and surface 

■ ■'■ if lot t mating solid colour objects Also includes Sweep. Extrude & Macro 

r - 1 1 f', ti es tor to ■*jg n mg v ery complex obfec (s easi ty Designs created with SolidCAD are 
, ,. a n F t r f. if ij : wild r he Realti me G rap tec s 1 anquago for h r gh-speed theker * tree animation. 
iti’> ..■ .tom Airhtmedes versiona/so performs smoothshading tor re^sm. 

S-^ti j CA Dt 4 r t 11 1 nor s t an upgrade to the Realtime Solids Modetler (Arc} for €40. EX? 

E49.95 (ARC Or BBC BIB */Master), 


REALTIME SOLIDS MODELLER 

rm« package me Judes both the sophisticated design environment of SotrdCdD and top 
togn speedanimation capability of a Realtime Graphics Language(RGU module 
■ tevetoped m pure ARM Rise code tor supercharged performance. The package is ideal for 
An. hdvctutal design Interior design, Engineering design & teaching CDT. TheRGL 
t'nydtde tan tic used to create standalone flicker-tree animation of ctesrgns ftom your own 
programs 5m noth shading is also performed for realistic images Through our m- douse 
-upeihse tn AO Design and High-speed techmgues. noothetpackage can rival toedesrgn 
eninfonmeni & animation speed of fhe Realtime Solids Modeller 

£89,95 (ARC) 

REALTIME GRAPHICS LANGUAGE 

Trip Hya/time Graphics Language rom provides a complete 3D Solids? Wireframe 
animation system with 52 star commands and 3D Editors for designing objects lo animate 
from your own programs includes a 35.000 pixels sec tine generator tor last 3D drawing 
rafes JD Relate, Soate.Ortiil Perspective and Turttegraphios. Also compatible with 
designs Creared with SofirfCAOlflS'C}. 

£49.95 (BBC BIB + /Master) 

SUPER-DUMP 

I’m* ultimate printer driver which lakesadvantaqe of the higtiestipsotution capability of 
ordinary Epson compatible printers toprovrde rg^o io%4 resolution, /mages can also be 
sea tod positioned and previewed before printing. Fully compatible with SolidCAD. 

Hearn me Grap tires Langu age Gate Array design system & 3D CAD Animation system 
your own graphics programs or other C^-Dpackages can be made compatible with Super- 
Dump by the addition of a tew simple commands An example program is included in the 
package 

£15.95 (BBC BIB-+/Master), £24 95 (ARC) 


Presentation System 

The package provides 3P interactive environment to create, edd andpteyftac/r computer 
,-nr)|rented presentations for lectures and demonstrations. Also handies graph plotting tor 
pLiJyrnimrafs fi user defined functions which can be incorporated within the 
p resell fa from* 

£34.95 (BBC BfB + 1Master), £49.95 (ARC) 

All Archimedes software run in native mode on A305 - A44Q & A3QQQ with Arthur 1,2 or RISC OS 

SILICON VISION LTD. SIGNAL HOUSE, LYON ROAD, HARROW 
MIDDLESEX HA12AG. TEL: 01-4222274Or 01-8612173 
FAX: 01 4275169. TELEX: 918266SIGNAL G. 

E3 (Access/Mas (ere a rdIEuroc a rd accepted) 

All prices include VAT and Carnage (Overseas orders add £4). 
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Ttee ultimata PCS design system 
developed specifically tor ibe Archimedes 
with a specification that cannot be 
matched. Includes Automatic routing. 
Rais nesting, fl layers. Surface mot/ni 
capability, Q.OQ 1 resoJution. 32 3Z 
maximum board sire On line Help. East 
Zoom Pan Redraw. Text& Si/fcscreen 
facility. Variable Line Pad. Text Grid sizes. 
Part J.rbraries, B foe if /Wove Copy floiafe 
Muror Erase options, and up to 300^00 
components. 

For hardcopy the system supports the 
industry standard HP-GL GRAPHTEC. 

PL 0 TMA T £ plotters a nd pnn ters a r then 
highes t resolutions. A Iso pro vides 
automatic dnSlmg information with 
ex Tensive support from PCB 
manufacturers for final layout and 
production, optional ? year te/eptiane 
Hotline support (£ J00) and s oftware 
maintenance service (C7$f rs also 
available 


£195,00 (ARC) 


Rise BASIC 

T7io hr si Hue BASIC V syntax compiler 
which writ convert your programs info 
supercharged Rise code tor turbo 
performance teavmg sne competition 
standing. Features include Relocatable 
modules, full cross references. Double 
precision floating point .5 integer support 
in-Ime as sembfy Window- based or 
command fine compilation environment, 
standalone code generator, object code 
optimiser. tuff array manipulation and 
dimensions support, multiple exit 
structures & lull runtime error handier. 

£99.95 (ARC) 

RiscFORTH 

A new 32-bit implementation of (tie 
FORTH-83 standard, designed fo take fuil 
advantage of toe ARM architecture. 
Features include Mute-tasking. 

Optimising tompiter, ijuiti-in ARM 
assembler with floating poinl mnemonics, 
bui/ti/n Fuli screen Editor, Fife system 
infer face, OS calls support. Floating point 
(t Integer mates. WIMP support. Single - 
step debugger, Shadow screen tor 
documentation. Block rnanipufa/ior), 
Dictionary & Vocabulary display. Cast 
finding and a standalone code generatot 

£99.95 (ARC) 
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2770 ENDPROC 
2780 : 

2790 DEFPROCquick_save 
2800 IF INSTR($file_name%,".")=0 ERROR 
1,"To save, drag the icon to a directory 
viewer." 

2810 SYS "OS_File",10,$file_name%,&FEF, 
,!first,!next 

2820 SYS "Wimp_CreateMenu",-l 
2830 ENDPROC 
2840 : 

2850 DEFFNleaf(A$) 

2860 WHILE INSTR(A$,".")>0 
2870 A$=MID$(A$, INSTR(A$, ".+1) 

2880 ENDWHILE 
2890 =A$ 

2900 : 

2910 DEFFNget_name(P%) 

2920 A$="" 

2930 WHILE ?P%<>0 AND ?P%<>13 
2940 A$=A$+CHR$?P%:P%+=1 
2950 ENDWHILE 
2960 =A$ 

2970 : 

3020 DEFPROCcaret(W%,I%,X%) 

3030 SYS "Wimp_SetCaretPosition",W%,1%, 
X%,,-1,-1 
3040 ENDPROC 
3050 : 

3060 DEFFNaddr(!block%) 

3070 block%!4=0:SYS "Wimp_GetIconState" 
,,block% 

3080 =(block%!28)-4 
3090 : 

3100 DEFFNget_note_num(W%) 

3110 N%=0 

3120 WHILE w_note%(N%)OW% N%+=1:ENDWHI 
LE 

3130 =N% 

3140 : 

3280 max_notes%=250:DIM notes% 168*max_ 
notes% 

3470 DIM w_note%(4),note_date%(4),date% 
(4):date% ()=-l 
3480 FORN%=0TO4 

3490 w_note% (N%) =FNcreate__window ("", not 
e_date%(N%),30,999,884-N%*88,652,164,0,1 
2,31) 

3500 NEXT 
3510 : 

3520 w_save%=FNcreate_window("Save as:" 
,A%,0,0, 0,246,168,1,2,&93) 
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3530 A%=FNind_icon(w_save%,A%,1,9, "file 
_fef", 88,-92,68,68,S6102) 

3540 DIM t 3:$t="A~ " 

3550 A%=FNind_icon(w_save%,file_name%,t 
,255,"DiaryFile",8,-160,180,48,S700F12D) 
3560 i_ok%=FNicon(w_save%,"OK",194,-160 
,44,48,SC7019025) 

3570 PROCassemble 
3580 : 

3590 SYS "OS_GetEnv" TO AS 
3600 IF RIGHTS (AS, 1)0" " PROCload_note 
s(MIDS(AS,INSTR(AS,""" ")+2)) 

4090 CASE $ (I%+12) OF 

4100 WHEN "Save notes" : I%!4=w_save% 

4110 WHEN "Print notes" : I%!4=raenu%+20 

0 

4120 PROCcreate_menu(I%!4,"Print notes" 
,"month's,year's,all,") 

4130 ENDCASE 
4180 : 

4190 DEFPROCassemble 

4200 DIM code% 128 

4210 FORA%=0TO2STEP2:P%=code% 

4220 (OPT A% 

4230 .find_entry LDR R0,first 
4250 .search:SUB R0,R0,#168 
4270 LDR R1,next STR R0,[R1] 

4290 ,next_entry 

4300 LDR R2,[R0,#168]!:TEQ R0,R1 
4320 MOVEQ PC,R14:CMP R4,R2 
4340 BHI next_entry:MOV PC,R14 
4360 : 

4370 .insert_entry 

4380 LDR R1,next:ADD R2,R1,#168 

4400 STR R2,next:,move_up 

4420 TEQ R0,R1:MOVEQ PC,R14 

4440 LDR R2,[Rl,#-4]!:STR R2,[Rl,*168) 

4460 B move_up 

4470 : 

4480 .delete_entry 

4490 LDR R0, next:SUB R2,R0,#168 

4510 STR R2,next 

4520 .move_down TEQ R0,R1 

4540 MOVEQ PC,R14:LDR R2,(R1,#168] 

4560 STR R2,(Rl),#4:B move_down 
4580 : 

4590 .buff EQUD 0:.first EQUD notes% 
4610 .next EQUD notes* 

4620 .max EQUD notes%+168*max_notes% 
4630 1:NEXT 

4640 ENDPROC JjJJJ 

47 






ARM CODE SINGLE STEPPER w 


David Spencer adds enhancements to last month's program, Including dual 

screen operation. 


A potential problem with any debugger 
program is that the screen output it produces 
will interfere with that produced by the target 
program. To get around this there are a 
number of possible solutions: 

1. Restrict the debugger's output to a 
window on the screen, saving that window 
before it is used, and restoring it afterwards. 

2. Use two banks of screen memory, 
devoting one to the program's output and the 
other to the debugger. 

3. Communicate with the debugger via a 
remote terminal, using the serial port as an 
interface. 

Each of these methods has its own 
advantages and disadvantages. With the first 
method the output 'screen’ for the debugger 
is limited In size, and hence the information 
that can be displayed is restricted. The 
second method is better, but requires two 
complete screen banks which could cause 
memory problems. The serial port solution 
solves all these problems, but requires extra 
hardware to implement. The additions to the 
single stepper given here allow dual screens, 
or serial port output to be used. 

Start by adding the lines given here to the 
listing from last month. It is obviously important 
that the original program has not been 
renumbered in any way. Once the changes 
have been made, save the new program. The 
program can then be run and the new module 
installed as described last month. 

USING THE NEW MODULE 

The single stepper Is started as before, 
but will now select the dual screen, and clear 
it. Pressing the Tab key will display the 
program's screen, which is where all the 
program output will be generated. A 
subsequent keypress will return to the single 
stepper screen. All the other commands are 
as before. When using dual screens, there 
must be sufficient memory to allow two 
banks of screen RAM for the current mode. 

To use remote tracing through the serial 
port, the single stepper should be started 
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using either the command "SER1ALSTEP 
instead of "SINGLE STEP, or SWI 
“SingleStep_Serial3tep' 1 (&CG801), See last 
month's article for more details of starting the 
single stepper. The single stepper will use 
the currently set baud rate, data format, and 
XON/XOFF setting, so these must be set up 
beforehand using SYS "OS^SeriaiOp", or the 
equivalent *FX calls. Of course, the remote 
terminal must also be set up to send and 
receive plain text. If you have a Master 128 
then the built-in Terminal application is ideal. 
In this mode all screen output produced by 
the single stepper will be passed to the 
remote machine. Similarly, all the single 
stepper keyboard input will be taken from the 
remote machine, 

OTHER CHANGES 

A couple of other changes have been 
made to the original single stepper. Firstly, 
the VDU queue is now preserved across 
instructions. Previously, it was not possible 
to single step through multi-byte VDU 
sequences as the single stepper's own 
output got mixed with that produced by the 
program. 

Secondly, a further SWI has been added - 
,, SingleStep_StopStep t ’ (&C0802) which is 
equivalent to the 'G s command, in other 
words, it resumes normal execution from the 
next instruction. This SWI, together with SWI 
,, SingleStep_StartStep" can be used to 
bracket a particular section of interest within 
a larger program. 

A bug which caused the single stepper to 
’disappear" if the computer was reset while It 
was in use has also been corrected, 

80 DIM code 4000 

120 EQUD 0:EQUD service:EQUD title 

160 EQUS "StartStep 11 :EQUB 0 

161 EQUS "StartSerial n :EQUB 0 

162 EQUS "StOpStep^EQUB 0: EQUB 0 

260 EQUD shelp 

261 EQUS "Serialstep":EQUB 0:ALIGtt 

262 EQUD serial:EQUD Si0001:EQUD sssyn 
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263 EQUD sshelp:EQUB 0:ALIGN 

264 .sshelp EQUS "*Serlalstep invoices 
the machine code single stepper to work 
via a remote terminal.":EQUB 13 

265 .sssyn EQUS "Syntax: Serialstep <s 
tart address>":EQUB 0:ALIGN 

310 .Init MOV R6,R14;MQV R3,11536 
341 STR RO, [R2,#S400] 

360 .swi CMP Rll,#2:MOVHIS PC,R14 

370 LDR R12,[R12]:STRB Rll,[R12,1171) 

371 LDRB Rll, [R1.2,1169] :BEQ Swioff 

451 .serial LDR R12,[R12]:MOV R2,#l 

452 STUB R2,[M2,#171]:B stepl 

460 .step LDR R12,[R12]:MOV R2,f0 

461 STRB R2,[R12,#171)stepl 

611 MOV R0,#1:LDRB Rl,[R12,#171) 

612 CMP Rl,#1:MOVEQ RQ,#0:BLHE window 

613 STRB R0,(R12,#176);MOV R0,#0 

614 STRB RO,[R12,#177) 

615 STRB R0,[R12,#178):BL savevdu 
945 CMP R0,f9:BEQ tab 

1185 BL defwindow 

1271 BL restorevdu 

1272 BL defwindow 
2451 BL restorevdu 
2511 BL savevdu 

3670 .jumpback MOV PC,R14 
3680 .savevdu STMFD R13!,[R14) 

3690 MOV R0,#S3C:MQV R1,#0:MOV R2,#0 
3700 ADD R3,R12,#S400:SWI "OS_SpriteOp n 
3710 LDRB Rl,[R12,#171) 

3720 ORR Rl,Rl,Rl,LSL #l:MOV R2,#0 
3730 MOV R0,#&EC;SWI "OS_Byte" 

3740 LDRB Rl,[R12,#171]:MOV R0,#2:SWI " 
OS_Byte" 

3741 LDRB Rl,[ Rl 2, # 171 ]:CMP Rl,#l 

3742 BEQ savevdu2:MOV R0,#112 

3743 MOV Rl, #2 : SWI "OS_Byte" 

3744 MOV R0, #113:MOV Rl,#2 

3745 SWI "OS_Byte" 

3746 LDRB Rl,[R12,#178]:CMP R1,#0 

3747 BNE savevdu2:BL window 

3748 SWI S10C:MOV R0,#1:STRB R0,[R12,#1 
78) 

3749 ,savevdu2 

3750 LDMFD R13!,[PC} A 

3760 .restorevdu STMFD R13!,(R14) 

3770 MOV R0,#S3C:MOV R1,#0:MOV R2,#0 
3780 MOV R3,#1:SWI ,, OS_SpriteOp’' 

3790 MOV Rl,#0:MOV R2,#0 
3800 MOV R0,#SEC:SWI "OS_Byte" 


ARM CODE SINGLE STEPPER 


3801 

3802 

3803 

3804 

3805 

3806 

3807 

3810 

3811 

3812 

3813 
4000 
4010 
4020 
4030 
4040 
4045 
4050 
4060 
4070 
4080 
4050 
4100 
4110 
4120 
4130 
4140 
4150 
4160 
4170 
4180 
4190 
4200 
4210 
4220 
4230 
4235 
4240 
4250 
4260 
4270 
4280 
4290 
4300 

) A 

4310 

4320 

4330 

9999 

10000 

e,0% 


MOV R0,# 2:MOV R1,#0:SWI "OSByte" 
LDRB Rl,[R12,#176];CMP Rl,#2 
MOV R0,#112 

MOV Rl,#1:$WI "OS Byte" 

MOV R0, #113:MOV Rl,#l 
SWI "OS Byte":B restorevdu3 
.restorevdu2 

.restorevduS LDRB R0,[R12,#177] 

CMP RO ,# 0:STRNEB R0,ER12,#176] 

MOVNE R0,#0:STRNEB R0,[R12,#177] 
LDMFD R13!,(PC) A 
,swioff LDR R0,[R12,#160] 

LDR Rl, [R12, #164]:STR Rl, [RO] 

MOV RQ,# 0:STR R0, [R12,#169] 

MOVS PC,Rl4 

.window STMFD R13!,{R14] 

MVN RO,# 0:MOV Rl,#1 
SWI "OSReadModeVariable" 

MOV R3,R2 

MVN R0, # 0:MOV Rl,#2 
SWI "GS_Re a dModeV ariab1e" 

SWI £100+28:MGV RQ,#0 
SWI "OSWriteC" 

MOV R0 r R2:SWI "OSWriteC" 

MOV R0,R3:SWI "OSWriteC" 

MOV R0, # 0 : SWI "OSJfriteC" 

LDMFD R13!,{PC} A 
.tab LDRB R0, [R12, #171] 

CMP R0,# 0:BNE main 
BL restorevdu 
.tab2 SWI "OS_ReadC" 

BCC tab3:MOV RO,#£7E 
SWI "OSByte" 

.tab3 BL savevdu 
B main 

.defwindow STMFD R13!,{R14} 

MOV R0,#134 

SWI w OS_Byte":SWI £100+26 
SWI &100+31:MOV RO,Rl 
SWI "OSWriteC":MOV R0,R2 
SWI "OS_WriteC" 

LDMFD R13!,{PC} A 
.service STMFD R13!,{R0-R2,R14} 

CMP R1,#G27:LDMNEFD Rl3!,{R0-R2, PC 

LDR R2,[R12]:MOV R0,#0 
STRB R0, [R2,#169] 

LDMFD R13!,{R0“R2,PC] A 
] NEXT 

SYS B 0$_File",10,"Sstep”,SFFA,,cod 

m 
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We offer 
a unique 
inspection 
copy service 


/ NOW 
RISC OS 
COMPATIBLE 


^ Archimedes WIMPS system? 

VOU can easily and quickly build multi-window programs lor Archimedes with pop-up 
menus, icons, mouse control, etc, of a professional quality. All in BBC Basic, With RISC 
OS your programs are multi-tasking and installed on the icon bar, 

ARCHWAY provides a total environment for programming with tools, run-lime code, 
program shells, extensive examples and a library of functions and procedures. 

The tools let you define and edit windows, multi-level menus, icons, mouse pointers 
and much more. The cut, copy and paste, undo, on-line help and hard copy print out 
facilities give you power as well as ease of use and convenience. 

The run-time code becomes part of any program you create. It automatically handles 
windows, menus, icons, etc. for you. For example, opening a window can involve little 
more than calling a function with the window s name. Attach a menu name toa window 
using the tools and the menu functions without you writing a line of code. Give a menu 
item a command name and when a user chooses il a fund ton in your code with the same 
name is called. Vou just write the contents of the function. 

An in-depth user guide fakes you gently step-by-step through f7Q QC 
a progressive series of program building examples, All 

examples are on disc ready to run. lnc\. VAT & p/p 

The complete system comes on 4*0GOk discs { 3tools & 1 run-time) with a 300-+ page, ring- 
bound user guide. You need 1M of RAM to run the tools. One disc drive is sufficient. No 
extra licence fee to distribute copies of the run-time in your programs. 

AVAILABLE SOON; A Major New Release {VL 1). Many new features; eg powerful 
graphics and text facilities for your programs by multitasking cooperation with the RISC 
OS Draw, Edit and Paint programs. BUY ARCHWAY NOW AND UPGRADE WITHOUT 
FURTHER CHARGE1 


4 CLARENCE DRIVE, EAST GRINSTEAD, 

WEST SUSSEX RH19 4RZ Telephone (0342) 328188 


Cheques/PO$/offidal orders or Access/Visa number and 
expiry date. 24-hour 'phone for Credit Card orders. 
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Into the ARC - All About Sprites 

By Mike Williams 


This series of articles, entitled Into the 
Arc, is intended to introduce the newcomer 
to the Archimedes to its various features. 
Previously, I have tended to concentrate on 
certain aspects which are important when 
you want to write programs in Basic, but our 
series is not aimed only at programmers. It is 
also our intention to cover other aspects of 
the Archimedes system for the benefit of 
programmers and users alike. 

This month, therefore, 1 propose to look 
at the use of sprites on the Archimedes. You 
can hardly miss them anyway, as they are 
visible on the screen from the moment you 
switch on your Archimedes and the Desktop 
appears. Many of the icons you see on the 
screen are sprites, and in the course of this 
article I will show you how to create a sprite 
to represent any program in a directory 
viewer. Sprites are often used within 
programs as well, to provide a wealth of 
graphics objects to be used as the program 
determines, I will also be dealing with this 
and the commands provided by RISC OS for 
this purpose. 

Although a sprite is just a graphics image, 
what distinguishes a sprite from any other 
form of graphics is that the Archimedes has 
a range of built-in functions specifically for 
manipulating sprites. This makes life 
particularly easy for the user, and results in 
some very efficient screen operations. 

In fact, sprites can be treated in two 
ways, as system sprites and as user sprites. 
System sprites are the ones we are talking 
about, and one of the things you need to 
watch is the allocation of sufficient memory 
for the sprites you are using with the help of 
the Task Manager. User sprites are similar, 
but everything about them including the 
allocation of memory is directly under the 
control of the user program. Many of the 
programs on the Applications discs, and 
much commercial software, use user sprites, 
which Is why you never need to worry about 
allocating sprite space when using these 
programs. For more information on user 
sprites refer to the article on this subject in 


RISC User Volume 2 Issue 3, and again in 
Volume 2 Issue 6. 

GETTING STARTED 

One of the easiest ways of finding out 
more about sprites is by using the Paint 
program supplied on Applications Disc 1. In 
fact, this package has as Its prime function 
the creation and editing of sprites, so what 
more could we want? 

Sprites are saved in a sprite fife, and there 
is a sample sprite file on the disc called 
PaintDemo. Once you have installed the Paint 
application on the menu bar (as described in 
the User Guide) just drag the sprite file icon 
over the Paint icon to get started. 

Alternatively, double click on any application 
icon on an Applications disc while holding 
down the Shift key. This will open the 
application's directory, displaying the files which 
comprise that application, including a file called 
^Sprites, and maybe another file called Sprites 
as well. All sprite files are distinguished by the 
paintbrush-over-house image. 

Try this out for the Paint application itself. 
Drag the ^Sprites file over the Paint icon, and 
a window wilt open showing two sprites 
which are the large and small icons used to 
represent Paint on the screen. If you do the 
same with the file Sprites, the resulting 
window will show the 49 different sprites 
used by the Paint program. 

At this stage what we are seeing is a 
sprite file window. The sprite file has been 
loaded into memory, and any of the sprites 
can be selected and edited. This is 
accomplished by double clicking on any 
individual sprite. This in turn opens a sprite 
window showing the sprite itself. Clicking the 
Menu button over the sprite window reveals a 
series of options. In particular, the Paint option 
allows you to Show colours (the palette used 
by the sprite), and to Show toots (the tools 
which you use for creating and editing 
sprites). There Is also a zoom option which 
allows you to temporarily enlarge or shrink a 
sprite to help with any editing. 
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One point to note concerns the saving of a 
newly created or edited sprite. Clicking Menu 
over a sprite window provides the usual RISC 
OS save option. Drag the sprite icon to the 
sprite file window. This saves the sprite in the 
current copy of the sprit© file in memory. It does 
not alter any copy of the sprite file previously 
saved to disc. To do this, click the Menu button, 
this time over the sprite file window, and repeat 
the save operation, this time dragging the 
relevant file icon to the directory viewer where 
you want to save the file. So remember, saving 
a sprite only produces a temporary copy In 
memory; a second save is needed to make a 
permanent copy on disc. 

Of course, if you edit and save any of the 
sprites used by the Applications discs, you 
could end up permanently changing some of 
these carefully designed Icons, so beware. 
Let's look instead at how we could create an 
icon ourselves. 

First of all click on the Paint icon on the 
menu bar which will open up an empty sprite 
file window. Now click the Menu button over 
this window and choose Create , Enter a 
name for your sprite (whatever you choose). 
We also have to specify a size for the sprite 
in terms of pixels. A sprite used as a file icon 
is usually 34 pixels wide by 17 high, so that's 
what well choose. The other information can 
be ignored as long as we do not use a 256 
colour mode. Click on ‘OK 1 and a blank sprite 
of the size defined will appear in the sprite 
file window with the name you chose. 

Now double click on this icon to open its 
sprite window (which will be blank at this 
stage). You can now proceed to design your 
sprite. If you haven't used Paint much before, 
then click the Menu button over the sprite 
window, choosing Paint and then Show 
cotours . From now on Select whichever cotour 
you want to work with and colour in the pixels 
for your sprite. Remember that the sprite 
window is just a window, and you would be well 
advised to drag the window to its maximum 
size using the bottom right-hand comer so that 
you can see your sprite design in full. 

It's also a good idea to position the colour 
palette window, the sprite window and the 
sprite file window so that all three are visible 
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at the same time. You can then readily select 
colours at will, and you can see your sprite at 
normal size building up in the sprite file 
window if you create it at a magnified size in 
the sprite file window. Of course, Paint offers 
many other facilities, and these are 
described at length in the User Guide, 

Once you are satisfied with your sprite 
then you need to save it to the sprite file in 
memory, and then save the sprite file to disc, 
tt obviously makes sense to create a 
directory in which to put any and all of the 
sprite files which you build up. Remember 
too, that by repeating the process described 
above (by clicking Menu over the sprite file 
window and selecting Create ) you could 
create a second and further sprites, saving 
them all in the same sprite file. 

Now let's see how we could use the sprite 
we have created as an icon to represent a 
program in a directory viewer. Suppose our 
application is to be called ‘RiseEx'. First of alt 
you will need to create a new directory with 
the name IRiscEx (open the directory viewer 
for your disc, and then press Menu to select 
the appropriate option - New directory). At 
the moment the Icon for this will be the 
standard RISC OS applications icon. Now 
hold down the Shift key and double click on 
this icon to open the corresponding directory 
viewer. Copy, by dragging, your program into 
this window, and then rename it as 
IRunlmage (click on Menu, selecting the file 
name, and then the Rename option). 

Next, copy your sprite file from wherever 
you saved it into the same window and 
rename this as fSprites. To make everything 
work properly you will also need to change the 
name of the sprite which represents your 
program so that it has the same name, in our 
example IRiscEx. To do this drag the sprite file 
from the IRiscEx directory to Paint in order to 
open the sprite file window. Now use the Menu 
button, selecting the Rename option to change 
the name of the sprite itself to IRiscEx, and re¬ 
save the sprite file again as ISprites. 

If you now remove all the windows from 
the screen, and then click on the drive icon 
on the menu bar to re-open the directory 
viewer for your disc, you should find that 
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your application is represented by the icon 
which you created with Paint. If you are 
, editing or changing an existing sprite, you 
will also need to press Ctrl-Break before 
clicking on the drive icon because of the way 
the Wimp sprite area is organised. 

In order to complete the application, you 
will also need to use Edit to create one more 
short file, to be called !Run, to be saved in 
the IRiscEx directory. 

Assuming Edit has been installed, click 
with the Menu button on the Edit Icon, 
selecting Create and then New Obey file. In 
the Edit window which appears enter: 

WimpSlot -min 32K -max 32K 

Run <Obey$Dir>.!Runlmage %*0 
and save this file in the IRiscEx directory as 
[Run. The value given with the WfmpSlot 
command will depend on the size of your 
program. Remember that to open the 
IRiscEx directory you will need to double 
click on its icon while you hold down the Shift 
key, because it is an applications directory. 
For more help in creating an applications 
directory, refer to the article on this subject in 
RISC User Volume 2 Issue 4. 

The end result Is not only that your 
program wilt be represented by a customised 
icon on the screen, but that your program 
can be run from the Desktop simply by 
double clicking on its Icon. 

The above description of the steps needed 
may sound daunting, but if you follow what I 
have described, referring to the User Guide 
and other articles cited you should be able to 
achieve the same result* and the effort of 
[earning this process is well worthwhile for the 
professional results achieved. After a few 
fries, you should find the whole process quite 
straightforward to use. 

SPRITE COMMANDS 

As I said at the start there are two 
obvious uses for sprites, as icons to 
represent files and programs, and as icons 
or other objects which we can use within a 
program. For the latter, RISC OS provides a 
number of commands. Assuming you have 
created a sprite file with one or more sprites 
as already described, proceed as follows. 


Exit from the Desktop (press Ctrl-Shift- 
F12) and enter Basic by typing BASIC. Use 
the 'DIR command to get to the directory 
containing your sprite file and enter: 

*SLOAD <sprite file> 
specifying the appropriate name, e.g.: 

*SL0AD Mysprites 

This loads the sprite file into the system 
sprite area of memory. If there is insufficient 
space, go back to the Desktop ('Desktop) 
and use the Task Manager to allocate more 
sprite space. 

Assuming that ad Ss well, the command: 

*SList 

will fist the names of the sprites contained in 
that sprite file, for example: 

spritel 

sprite2 

car 

boat 

etc 

Within a program, any action such as placing 
a sprite in a particular position on the screen, 
refers to the current sprite. This is 
determined by the command 'SChoose, e.g.: 

*5Choose spritel 

Once a sprite has been selected as the 
current sprite it can be positioned wherever 
you like on the screen with Basic's PLOT 
instruction. If you had a sprite called Car in 
your sprite file, then; 

*SChoose car 
PLOT £ED,0,0 

would plot the sprite on the screen with its 
bottom left-hand corner in position (0*0), the 
bottom left-hand corner of the screen. All the 
usual considerations that apply to graphics, 
such as style of plotting (Exclusive OR 
plotting for example) can be applied to sprites. 

For more information on the subject of 
sprites, see the article Animating Archie in 
RISC User Volume 1 Issue 8. See also the 
User Guide with regard to the use of Faint, 
and the Basic Guide for information on the 
various commands that may be used to 
manipulate sprites from within Basic 
programs. Above all else, greater familiarity 
with the subject is best achieved by 
experimenting yourself* and l hope this article 
will have given you the encouragement to do 
that. gg 
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ARE YOU GOOD ENOUGH? 

As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 

If you have written any programs, completed or not, then we would like 

to hear from you. 

If you have any Ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 

If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 

Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use, If 
your program does what is meant to do then thats all we are interested in. 
Why not Join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 

The most Important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 

Please write, in confidence, to Mr. D, Clare at: 

Clares Micro Supplies, 

98 Middlewich Road, 

Northwich, 

CHESHIRE CW9 7DA 

If you have a program either complete or in development then please 
enclose a copy for our evaluation. 

To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 

Act today and become part of the leading software team producing 
software for the worlds fastest micro. 



















INDIRECTION OPERATORS EXPLAINED 


Lee Calcraft looks at the operators provided by ARM Basic for 
directly accessing memory. 


There are many reasons why you may 
need to access memory directly on an 
Archimedes. You might for example need to 
work with text strings longer than the 255 
character limit Imposed by Basic, or you may 
need to set up parameter blocks for use with 
SYS calls. Here is how it is done. 

RESERVING MEMORY 

First of all you must reserve an area of 
memory. You should never attempt to access 
memory directly by giving a logical address 
(though this practice was acceptable on the old 
BBC micro). To reserve an area of memory, a 
version of the DIM statement is used: 

DIM ram% 40 

will reserve 41 bytes of RAM (i.e. one byte 
more than specified) for use by your program, 
and the variable ram% will be set (by Basic) to 
the start address of this block. It is worth noting 
that this block is always word-aligned (i.e. the 
start address is always divisible by 4). 

READING AND WRITING TO MEMORY 

Four so-called indirection operators are 
provided for reading and writing directly to 
memory - see Figure 1. 


Symbol 

Purpose 

No of bytes 

? 

read/write a byte 

1 

1 

read/write an integer 

4 

1 

read/write floating pt 

5 

$ 

read/write a string 

Oto 256 


Figure 1 

Basic's four indirection operators 


To print the four-byte (-32 bit) value at ram%, 
use: 

PRINT !ram% 

The two operators I and ? (but not | or $) 
can make use of a special so-called dyadic 
form of notation, where: 

ram%?4 is equivalent to ?(ram%+4) 
and 

ram%M00 equates to l(ram%+100) 

In other words, the address is formed by 
adding the two values together. The value 
before the operator must be a variable, while 
the second value may be a variable, a number 
or a bracketed expression. 

The “I" operator (the “I" key is just above 
the Return key) functions similarly, except that 
it uses five consecutive bytes, and is used for 
treating floating point numbers. The range of 

thAQA |C* 

-1.7*10*38 to 1.7x10 A 38 
with an accuracy of 9 significant figures. 

The $ operator will store and retrieve 
strings. To store the string “bananas" at ram%, 
use: 

$ram%-"bananas" 

The effect of this is to store ASCII "b M at ram%, 
ASCII “a" at rarn%+1, and so on. A carriage 
return character (ASCII 13) is automatically 
added at the end of the string in memory (in 
this case at ram%+ 7), but this is not echoed 
when the string is retrieved. Thus if you use: 

A$-$ram% 

to read the string into A$, the latter will not 
contain a carriage return. 


To store a byte of value 255 at the location 
ram%, use: 

?ram%-255 

Only integers in the range 0 to 255 may be 
stored in this way. To print out the value at 
ram%, use: 

PRINT ?ram% 

This will only work of course if you have 
already reserved an area of RAM at ram%. 

The pling operator (I) works in a similar 
way: 

!ram%-100000 

will store the value 100000 at ram%. But now it 
is stored in four consecutive bytes (low byte 
first), providing a much greater range: 
-2147483648 to 2147483647 


Finally, you might like to try the short 
accompanying program to demonstrate the 
use of each operator. 


10 REM >fttemAcceas 

20 REM Demo of indirection ops 

30 REM- 

40 DIM ram% &100 

50 REM-store 

60 ?ram%-255 

70 ram%14-100000 

80 |(ram%+8)=1.23456789876E9 

90 $(ram%+13)-"String storage" 

100 REM-retrieve 

110 PRINT?rara% 

120 PRINTram%!4 
130 PRINT|(ram%+8) 

140 PRINT$(ram%+13) 


Qg 
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I mpression is more than a 
word processor. It can 
handle all aspects of the 
final printed result - ihe text, 
line graphics, photographs, 

company logos etc, Yel it can still be used to bash out 
a single page of text as well as any ‘simple* word 
processor. It is a document processor. 

filSCQS 


eitifcred you do hot : have to 
worry about creating new 
frames or pages. 


- Graphics frames may contain 

any sprite (for example images from Scan-Light) or any 
Draw file. All graphic frames may have the picture 
scaled within the frame to any degree. In addition the 
aspect ratio of pictures can be controlled and even 
locked to any required value. 


Impression is one of the lust products to take full 
advantage of the new multi-tasking WIMP based 
operating system for the Archimedes, so it is simple 
and intuitive to use - long gone are the days when users 
had to remember commands, or codes for each opera- 
lion. Only five main menu options control 
everything within Impression. 

I hc program is written in ARM assembler so it 
is very fast and very responsive, and uses the 
minimum possible RAM space. 

Frames 

Impression is a frame based page 
layout sysicm. All objects on the 
page are held within frames which 
may be positioned freely anywhere 
on the page. Frames can contain text 
or graphics, they may overlap, and may be transparent 
or have any coloured background. They can have a 
variety of borders displayed around them and may be 
arranged in columns to create multi-columned text. 

Text frames may be linked to other text frames (even 
on subsequent pages) so text will automatically flow 
from frame to frame anti page to page. Since Impres¬ 
sion has been designed primarily as a word processor, it 
is important that users can enter text unhindered. 
Therefore frames and pages are created automatically 
as text Hows out of a frame, so that while text is being 




Windows 

Impression can handle up to 16 documents in memory 
at any one time, each being viewed in one or more 
windows. Each individual view may lie scaled as 
required so that, for example, one view may be 
at 100% while another window shows the same 
document scaled lo 20% so showing a Jive 
'mini* view or multiple page 'thumb-nail' 
views. This mechanism also allows two differ¬ 
ent parts of a document lo he edited without 
the need to scroll between them. Impression 
can display its pages within the window as 
side-by-side Icft/right pages, and as 
vertically arranged pages in a more 
word processor-like fashion. There is 
no need to specifically turn over the 
page, thereby overcoming a limita¬ 
tion of traditional DTP systems. 

Spelling checker 

Included with Impression is a 60,000 word spelling 
checker providing some of the most advanced spelling 
facilities. Check-as-you-type, user dictionaries, ignore 
dictionary, crossword and anagram solving and an 
intelligent 'guess’ feature are included. Other related 
dictionaries control automatic abbreviation expansion 
as you type, and a hyphenation exception dictionary for 
precise hyphenation control over and above ihe normal 
a u tomat i c h yphenalion. 









Other features: 


processors on the 

supports a system of styles. Rather 
than having fixed texi effects such 
as bold, underline etc. 

Impression allows 
the user to apply 
any user named 
style to any part 
of the text. This 
style may he 
defined and 
re-defined at 
any lime to represent any combination of stylistic 
effects* So for example one style, perhaps called 
'heading’, may specify text to be in a Times font, one 
inch high, in italics and centered. This style may then be 
applied to any region of text with one key-press. 

Printing 

Included arc the latest RISCOS printer drivers for Epson 
compatible 4 and 24 pin printers, and LaserJet eompat 
ible laser, ink-jet. and PostScript printers. These printer 
drivers ensure the output is to the maximum resolution 
the printer can manage. Impression also supports 'text 
mode' draft printing so text may be output as fasl as 
possible using the printers character set. The user 
therefore has a choice between fast, text only printing or 
high quality text (any font, any size) and graphics 
printing. 

Impression cotties iviih a 'no quibble' money hack 

gitarwtee when purchased direct from Computer 
Concepts. ■ 


•Master pages for consistent document design, 

•All measurements may be specified in inches, mm. cm, 
points, picas, all loan accuracy of l/72000ihs inch. 
•Ideal for a 1 Mbyte machine - over 3D0K free memory! 
•Fast automatic disc spooling of documents larger than 
memory, allowing virtually unlimited document size. 
•Print multiple pages per sheet, any scale and rotated, 
•Includes Acorn's new outline font system and fonts. 
•Fast graphic scale and PostScript graphics printing, 
•Automatic index generation. 

•The package includes a 200 page manual (produced 
entirely with Impression), with tutorial, introduction 
and reference sections. Four discs include Impression, 
the printer drivers, the outline font manager and fonts, 
example document. Line-an examples, utility programs 
etc. An independently produced guide book to 
typography and page design is also included, 

ET49.00 +VAT (£171.35 Lnc) 


Thtx advert h'ir.v demurred, entered, km! out amt edited hmi impression. A mure detailed brochure is available from; 

Ail ft ijfr > v h err * rented in O/ uh- and imparted hint impression frames. 

Computer Concepts Ltd 


h kit h output the fittnf ronteru ready armurL The stadia photographs 
n-irJT then punted over warned versions. 


The paprjt t^rie then 'pt lured' via the htstStripi printer drivers to dim 
This tfixi. ftU- imi then neat direr dy to a Liimmnr photo-rvpeseiter. 


Gadde^en Place, Hemel Hempsicad, Herts HP2 6EX, t«442) frVFtf 
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REVIEWS 


GET ORGANISED WITH MEWSOFT 


Mike Williams reviews three small packages designed to help you 

organise your life. 


MEWsoft is a small supplier of original 
software that first came to attention with its 
FAX*FILE package for the BBC micro. This 
was followed by an A4 Forms Designer and 
a Fancy Labels Manager. All three packages 
have been extensively rewritten for the 
Archimedes. 

Although small in scale, any or all of 
these packages could prove very effective 
for the home user and others. All three can 
be run from the Desktop, but thereafter 
follow their own style for layouts, menus and 
the like. In fact, there is considerable 
variation here both within each package and 
between packages. I find this less satisfying 
than a consistent approach. 

PERSONAL ORGANISER 

FAX*FILE is basically a computerised 
personal organiser, and ail its printouts are 
designed to be of that size (MEWsoft can 
supply suitably sized paper). However, you 
can also use it purely as a screen-based aid. 
There is an address book and diary, a forms 
designer (design your own organiser forms), 
calendar, and small database. The address 
book allows only three lines for an address 
which I feel is limiting, but otherwise works 
well. As well as printing pages for your 
organiser, you can also print address labels, 
either singly or by tagging those required. 

The diary promises month per page, 
week per page or two days per page 
formats, but the screen diary allows just one 
line per day. Choice of format Is restricted to 
the printing phase. Options exist to create 
and edit entries, search, browse, save and 
load. ! have never been a fan of 
computerised diaries, never having pockets 
large enough to carry a computer, and I 
would suggest the best use of the diary 
feature here is in the printing of blank or 
customised diary pages for insertion in your 
organiser. 

The forms designer allows both text and 
vertical and horizontal lines to be combined 
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in designing forms for your organiser, and 
some 12 sample forms are Included on disc. 
The mini database allows up to 60 records of 
4 fields, and a sample file is included. 
Facilities are simple but adequate for its 
purpose, while saved data can also be 
incorporated onto forms by the Forms 
Printer 

FORMS MANAGER 

The Forms Manager allows a variety of 
forms to be designed up to A4 size, or to a 
size suitable for a personal organiser, and in 
both cases forms may be vertical or 
horizontal. Again, a dozen or so forms of 
various kinds are supplied, and these can 
also form the basis of further designs if you 
wish. It is also possible to print multiple 
copies of a form with different data Inserted 
each time. 

I have to confess that I found the 
instructions too brief, particularly on the 
principal subject of form design, to feel 
completely happy with this package. 
Additional information on design Is supplied 
by way of three sample forms, but I would 
much prefer to have seen this in the manual 
for ease of reference. 

Once all this information has been 
mastered, then form design is 
straightforward, with the screen acting as a 
window onto the form. The function keys and 
cursor keys are used to control most 
functions, with text being entered as in a 
word processor. 

The software also uses the numeric 
keypad to enter corners, vertical and 
horizontal lines, and hatching (to one size). 
The samples supplied certainly help to show 
what can be achieved. 

THE FANCY LABELS MANAGER 

The main purpose of this package is to 
create all manner of labels with fancy frames 
and fonts. There is a frame editor to create 
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borders (and over 40 different styles are 
supplied on disc), and also a font editor (with 
12 different examples ready for use). In 
practice, creating a label involves designing 
or selecting the frame and font, setting the 
size for the label, and then typing in the 
required text message. Many examples are 
included, and the package is both easy and 
fun to use. 

DOCUMENTATION 

All three packages are clearly produced 
to a low budget, and that most obviously 
applies to the documentation. The manuals 
amount to 4 or (for FAX*FILE) 8 pages! 
Whilst I have no quibble regarding the quality 
of production, I feel that there are instances 
where greater clarity is desirable, and that 
more detail should have been included. 

CONCLUSIONS 

All three packages will provide a lot of 
fun as well as doing a useful job. I didn’t 


like the considerable variety in menu 
styles used within the packages. The 
software also seems less than robust, 
but the author is clearly only too willing to 
listen to customers and amend the 
software as required. The price of £27.90 
each inc. p&p seems reasonable, though 
a total of over £80 for all three strikes me 
as too high, and I would hope that the 
complete set could be offered at a lower 
price. On the whole, though, MEWsoft 
has produced a set of good, useable and 
practical applications which will satisfy 
many users. 


Products 

FAX‘FILE, Forms Manager, 


Fancy Labels 

Supplier 

MEWsoft 


11 Cressy Road, 


London NW3 2NB. 

Tel. 

01-267 2642 

Price 

£27.90 each inc. VAT 


BACKUP 
IN BROMLEY 

AUTHORISED ACORN DEALERS ^ 

We offer full technical backup, service and advice as well as 
a comprehensive range of software and hardware 
for your Archimedes. If you have a problem - we can 

help you. 

Call in for a software or hardware demonstration, 
or phone for prices and availability 

Data S tare 

6 Chatterton Road, Bromley, Kent 
Telephone ; 01-460 8991 (closed Wednesdays) 







Now you’ve got RISC OS 
you need its companion. 

The RISC OS Companion Volume 1 

Essential utilities to enhance the already 
very powerful RISC OS Desktop. 


!Terminal 
!StartUp 
!Notes 
tOptions 
ITheBin 
! Gen Boot 
IFileType 
! Cache It 
IStarComms 


a multi-tasking terminal emulator 

creates IBoot applications for floppy or hard discs 

a note taking addition to lEdit 

makes setting copy and wipe options easy 

for deleting files by dragging over an icon 

creates applications for Arthur 1.2 programs 

makes setting file types easy 

caches icons and file types for quick loading 

adds star commands to a menu 


PLUS utilities to convert View and WordWise files to 
1st Word Plus and iEdit 

All 100% Riscware 


£49.95 ex VAT from all good Acorn dealers 
(20% discount for education) 

Site/area licences available directly from 
Software Solutions 


Broadway House, 149-151 St Neots Road, 
Hardwick, Cambridge CB3 7QJ 
Tel. 0954 211760 Telecom Gold 74:YKK255 



rECHNICAL QUERIES 


WHICH MONITOR 

Dear Sirs , 

i am about to invest in an Archimedes 410/1, 
but f am a little confused about off the different 
types of monitor which con be used. Can you 
clarify the situation for me ? 

Michael Tayior 

The new 400/1 series can use a number of 
monitors. The cheapest is a standard 
monochrome type, but this hardly does justice 
to such an advanced system, and for this 
reason Acorn no longer offer a monochrome 
monitor. If you do want to follow this course, you 
can expect to pay about £80 for the monitor, 
and your Archimedes will also need a link 
changed inside it - this is described in the User 
Guide. 

The next level of monitor is a standard resolution 
colour one, such as the Acorn-bodged unit 
(which is actually made by Philips). These 
monitors, which cost between £200 and £300, 
provide adequate quality for most uses, but have 
a limited vertical resolution. This means that the 
display can appear rather 'llney' In the horizontal 
direction, and certain high resolution modes 
cannot be displayed. 

The creme de la creme of monitors Is the 
multisync. These effectively double the vertical 
resolution of the picture, allowing higher 
resolution modes, and also making the picture 
look clearer and more solid. This type of 
monitor Is highly desirable If you plan to use 
your Archimedes for Desktop Publishing, 
because fancy-fonts appear much crisper 
than with a standard monitor. The drawback Is 
that a multisync monitor will set you back over 
£500, about twice the cost of the standard 
type. 

Another type of monitor, which is only suitable for 
the 400/1 series and the old A440, is the very high 
resolution monochrome monitor. These offer 1152 
by 896 pixels on the screen, but only in 
monochrome. Such monitors ore really only for 
very specialised activities, especially when you 
consider that they cost well over £1000. A final 
type of monitor which con be used with the 
Archimedes is a PC VGA monitor. However, this 
greatly restricts the available screen modes, and 
is not really worth considering. 


The best advice we can give Is to suggest that 
you visit your local Acorn dealer, and have a look 
at all the types of monitor for yourself. 

David Spencer 


CONFIGURATION QUERY 

Dear Sir r 

f understand that the configuration settings of 
my Archimedes A3000 coutd be corrupted by 
certain applications, and if so I would have to 
configure it all by hand. Is this so, and is there a 
better way? 

Jane Fairchild 

Yes, this is certainly true. The configurations of all 
Archimedes computers are stored in battery- 
backed RAM, Poorly-written applications are 
capable of leaving your machine reconfigured. 
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It Is however, easy to save your current 
configurations to disc, and then reload them 
whenever necessary. We featured a short 
program to perform this feat some time ago in 
RISC User, in Volume 1 Issue 5 page 34 there is a 
hint entitled '"Save and Load Configuration 
Data' This hint contains all you need to know, 

Incidentally, you will find that ArcScan is 
particularly goad at turning up this kind of 
information. In this case, if you hod entered 
"Configuration' and "Load', and performed a 
keyword search with "AND' logic, you would 
have come up with the reference given here (In 
fact that is how I found it myself)- 

Lee Calcroft 
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ROBICO ADVENTURES 

FOR THE ARCHIMEDES 

T 

RISE IN CRIME (Archimedes 305/310/400£29.95) 

In the vast, galaxy-wide federation, you are one of the abnormal few: unconditioned, discontented and insubordinate I Can you rid yourself of the 
shackles of this conformist, mind-imprisoned society? Rise in Crime boasts over 396K of text, 400 individually described locations, 150 objects and 
several high resolution colour graphic screens f Mouse driven input and an advanced parser make this a superb addition to your Archimedes col lection 1 


FUGITIVE'S QUEST (Archimedes 310/400£29.95) 

As Paul Preston, respectable schoolmaster, your life is shattered when you are convicted of murder - a crime you did not commit I Set in 1952, against 
the stunning backdrop of southwest England, the hangman's noose awaits unless you escape and find the evidence to clear your name! Fugitive's 
Quest is a large adventure with about 230 locations, 80 objects and reams of well written text. An advanced parser, mouse driven input and several full 
colour, photo-quality illustrations complete the unmistakable feel of Robico quality. 


ENTHAR SEVEN (Archimedes 305/310/400 £29.95) 

ft is the distant future .,. Whilst on board a tiny Interplanetary Space Hopper its orbit begins to decay! Once on the planet surface can you escape and 
return, again, to the freedom of the stars? Enthar Seven is a disk based mega-adventure I It has 460 locations, 30 objects, a massive vocabulary and 
1200 messages! And that’s just the 8-bit versions! The Archimedes version has over 140K of text and some of the best graphics you'll ever seel 

You can order by telephone using your ACCESS card, or by cutting out the coupon below. All orders are despatched first class by return. 

_________ _____ ' -- 

To; ROBICO, 3 FAIRLAND CLOSE, LLANTRISANT, MID GLAMORGAN CF7 8QH Tel: (0443) 227354 

Name .......... 

Address ........,. 


ADVENTURE 

MODEL 

QTY 

PRICE 

TOTAL 

RISE IN CRIME 

ARC 


£29.95 


FUGITIVE'S QUEST 

ARC 


£29.95 


ENTHAR SEVEN 

ARC 


£29.95 




I enclose a cheque/postal order payable to R08IC0' for £ 
or please debit my ACCESS account; I —I—I—I—I—I— L 


Signature . 



Expiry Date 






















RISC USER DISCS AND RISC OS 

Having fitted the new RISC OS to my Arc I find that the 
RISC User Volume 1 Special Disc does not function. Can 
you please advise me? 

E.Swtft 

Other readers have written similarly regarding the 
monthly magazine disc. The essential requirement is that 
SpriteSize must be set to 16K or the menu witt not 
appear If the disc is run or booted from a mode 12 
Desktop, the default Scre&nSize of 80K wilt be adequate, 
but some programs on the disc may need ScreenSize to 
be set to 160K. This will normally be indicated in the 
accompanying text display. 

A further point to watch out for is the SpriteUtils module 
being unplugged. See this month's Hints and Tips for 
more details. 

MORE READERS 1 COMMENTS 

The main change I would personally like to see (in RISC 
User) would be a series of articles for people who are not 
complete novices, but have not had a deep grounding in 
earlier Acorn computers. The articles in RISC User are 
either too simple (like the June feature Into the Arc), or 
assume the reader knows all the technical terms that go 
with the Archimedes, Please can we have something at 
an intermediate level 

MJ.Parnell 

My sincerest thanks for the introduction of Into the Arc, It 
is wonderful to get some down to earth information written 
in an understandable language. I can't wait for the next 
instalment. I must confess 60% of the content of previous 
issues has gone over my head. However, the last June 
issue has begun to restore my interest again. I was 
forming the opinion that the Arc was just too good for me, 
a sentiment no doubt suffered by many other floundering 
owners. Congratulations - such basically simple advice is 
most welcome. 

Laura Blackburn 

A good many readers who responded to our reader 
survey also sent sometimes lengthy letters with 
additional ideas and suggestions. In terms of the 
contents of recent issues, there were some clear trends 
as far as likes and dislikes are concerned. and not 


always expected. For example, the most popular item (in 
terms of the number of times if was referenced) was also 
one of the least liked. 

It is unlikely that any magazine can publish a range of 
articles which are equally liked by ait readers. We try to 
provide variety, at a range of levels , but as the 
Archimedes market grows up, and with the advent of the 
A3000, it seems likely that we must take the interests of 
first time Acorn users more carefully into consideration. 

SELECTING TEXT IN ARC EDIT 

The review of ArcEdit in RISC User Volume 2 Issue 5 
identified the difficulty of marking or selecting a block of 
text larger than the screen by highlighting, because the 
window does not scroll when the pointer is moved outside 

it 

There is a way of achieving the desired result, by marking 
the start of the required block by double clicking on 
Select, and then moving to the end of the block and 
clicking on Adjust. The entire block is then marked. Adjust 
can also be used to de-select excess spaces included 
when a word is marked by double clicking Select. 

Nigel Jennings 

Mr. Jennings was not alone in identifying this solution. 
Mr.Galtagher adds that a marked block can be directly 
moved or copied between files in their separate windows 
without the use of an intermediate file. Other readers 
have also requested that we devote some magazine 
space to the other two RISC OS applications supplied by 
Acorn ■ Paint and Draw. 

PC MEMORY SPACE 

One disappointment with RISC OS Is the amount of RAM 
available under the PC Emulator, Previously, on my 310,1 
was able to obtain 606K by typing *PCPC with version 
1.2 of the emulator. However, executing the PC emulator 
from the new Desktop icon only releases 532K of RAM, 
while executing 'PC.PC only manages 409K RAM. Is 
there anyway of increasing the workspace? 

J.Gallagher 

The !PC application contains a configuration file which 
can be edited (with Edit) to free more memory The file 
contains full details. gg 

63 


RISC User October 1989 










ARCHIE POWER 

Holed Out realty shows off the power 
of the Archimedes at its best. The 
game is completely mouse controlled 
and features atmospheric digitised 
sound effects to convince you that you 
are really playing golf. 

• 

Each of the 3 versions of Holed Out 
include an Instruction Manual which 
features easy to follow guidelines, 
general rules of golf and detailed scale 
maps of all their respective 
36 holes. 

• 

The extra courses are generaly 
harder: narrower and smaller fairways, 
very ‘protective" bunkers, stronger 
winds, steeper slopes etc. etc. 


GOLF GAME 

EXTRA 

COURSES 

ARE NOW 
AVAILABLE 


'1 play golf ant this Is the nearest thing 
I've seen to the real game on a computer". 

arcHn JmWS 


REVIEWS 

‘In the June issue of the Micro User, Holed Out for the BBC Micro was 
described as a test of skill not to be missed. The same game has now been 
released for the Archimedes and it is quite a stunning piece of work, 
ranking with Zarch and Conqueror in quality.....The graphics are effective 
and have amusing little touches like the ripples when the baH hits the water 
and sand flying into the air when you are trying to get out of a bunker.. ..a 
great game.' THE MICRO USER August 89. 

‘Sound is definitely a feature of Holed Out. There are samples for all sorts 
of situations: hitting trees, splashing into water, dropping into the hole and 
of course whacking the ball. ‘ ACORN USER August '89. 


2 NEW VOLUMES 

In response to your many requests we have now produced 
2 volumes of extra courses. Each volume contains 2 
superbly designed brand new courses plus the original 
Holed Out main program: therefore you do not need the 
original Holed Out to play them. Each course has been me¬ 
ticulously created to test your golfing abilities to the limits. 
The holes are very varied and even Nick Faldo would need 
to use all his skills to keep up his recent record. 

Holed Out Extra Courses Volume 1 
Holed Out Extra Courses Volume 2 


CATALOGUE 

Sent with all orders!! 

Includes details of ARCADE 
SOCCER, WHITE MAGIC 


HOW TO GET HOLED OUT 

Archimedes 3 1/2” Discs 

HOLED OUT. 19.95 

HOLED OUT EXTRA COURSES 1....J6.65 
HOLED OUT EXTRA COURSES 2 .... 16.65 


All versions are available from most good dealers. 

Our mail order service is second to none. Send a - 

cheque, P.O. or Access/Visa details. All copies inirw, 

are sent the SAME day by 1st Class Post. 

Telephone orders with Access/Visa are also welcome 
24 Hour Answering Service, 7 days a week. 

TT 1 07491 7nnrai 


H* Fourth Pfmm/ffB 
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David Spencer rounds up another collection of hints and tips. 


MISSING SPRITE UTILS 
A problem in RISC OS frequently causes the SpriteUtils 
module to become unplugged when the new operating 
system is first installed. This module implements the 
sprite star commands, and therefore any program which 
uses system sprites will come up with an error such as: 

File 'Slqad' not found 
Typing 'UNPLUG wifi list the names of any unplugged 
modules, and if SpriteUtils' is among them the solution is 
to enter the command: 

*RMReInit SpriteUtils 
which wifi cure the problem once and for all. Of course. RISC 
OS programs should avoid using system sprites anyway, 

BASIC LIBRARY COMMANDS 
With any utility program, it is very useful to be able to 
place it in the library directory and execute it when 
needed with a star command This is particularly so for 
hard disc users who can build up a massive library of 
useful commands. The l Run$Type + system variables allow 
such utilities to be written in Basic, but it Is necessary to 
include some code in your program to read any 
parameters given to the command. The following 
procedure will do just this; 

1000 DEE PROCparams 
1010 DIM argS(lOU):arg%=0 
1020 SYS IT OS_GetEnv" TO AS 
1030 IF INSTR(A$, "-quit*') THEN 
1040 A$=MID$(A$ f INSTR(A$,"-quit")+6) 
1050 WHILE LEFT$(A$,1}<>” " A$=MID$(A$, 
2):ENDWHILE 

1060 WHILE A$<>" rt AND LEFTS(A$,1)= w n A 
$=MID$ (A$, 2):ENDWHILE 
1070 while ASo"" argS^" 

10S0 WHILE LEFTS (AS, 1)0" 11 AND A$O nn 
arg$=arg$+LEFT$(AS,1):A$-MID$(AS,2):ENDW 
HILE 

1090 argS(arg%)=arg$:arg%+—1 
1100 WHILE A$<>" " AND LEFTS (AS, 1) = T1 " A 
$=MID$(A$,2>:ENDWHILE 
1110 ENDWHILE 
1120 ENDIF 
1130 ENDPROC 

This will return with arg% containing the number of 
parameters, and the array arg$() containing the 


parameters, where parameters are taken to be space- 
separated, For example: 

*PROG Hello Goodbye 

has the two parameters Hello' and 'Goodbye'. 
Incidentally, the procedure must be called before any 
further star commands are issued. 

RISC OS RECURSION 

When using RISC OS, be very careful not to accidentally 
copy a directory into itself This can be done if you are 
dragging the directory's icon, and you inadvertently drop it 
into its own viewer. Because aft Desktop copies are 
recursive by default, the directory will be repeatedly copied 
into itself until the disc fills up. If this does happen, press 
Escape to stop the operation, and delete all the new copies. 

THE INTERNATIONAL MODULE (t) 

The new International Keyboard module included in RISC 
OS provides a very useful feature to allow any ASCII 
character to be entered at the keyboard. Ail you need to 
do is hold down either of the Alt keys, and type the ASCII 
code for the character on the numeric keypad. When Alt 
is released, the character will be entered into the 
keyboard buffer as If it had been typed directly. For 
example, Alt and keypad-44 will enter a comma, while Alt 
and key pad-128 will produce a square root symbol (also 
the WIMP's tick). Of course, this method would normally 
only be used to enter characters that cannot be generated 
directly from the keyboard. 

THE INTERNATIONAL MODULE (2) 

Another feature offered by the International Keyboard 
module is the ability to switch between any of the 
available keyboard layouts with a series of keypresses. 
For example, pressing Alt-Ctrl-FI will select the UK 
keyboard layout, while Alt-Ctrl-F2 will revert to the correct 
layout for the configured country. This can be very useful 
when, say, you have the Greek keyboard selected, if you 
need to switch back to the UK keyboard to enter star 
commands and the like. 

Alternatively, you can select the keyboard appropriate to 
any country offered by pressing Alt-Ctrl-F12, and then, 
without releasing Alt, typing the international telephone 
dialling code for the country on the numeric keypad. For 
example, 39 for Italy. A list of dialling codes can be found 
in the front of The Phone Book. 
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ARCSCAN DATA 

Index entries lor this issue of RISC User and the latest 
BEE BUG (Vo 1.8 Mo. 4) to be used with ArcScan. These ere 
fully compatible with the original ArcScan, and ArcScan II. 


BEEBUG Ltd 

117 Hatfield Road, St. Albans, 
Herts AL1 4JS 
Tel. (0727) 40303 


®]1><S 3D©©it M<a§D<S)28ffa© ®a@© 

October 1989 


£3.90 + £i p&p 


BONUS ITEMS 


A COLOUR IMAGE PROCESSOR 

A sophisticated program for converting between colour image 
formats whilst maintaining maximum resolution and colour 
consistency, A sample image is also included. 


DESKTOP DIARY (2) The complete RISC OS Desktop diary and calendar 
ASSEMBLER WORKSHOP A debugging aid from the first part of this new series for assembler users. 

ARM CODE SINGLE STEPPER (2) The single stepper module from last month's issue with additions for dual screen tracing 

and remote output via the serial port. 

AN ECON SELECTOR SHELL A set of routines to allow bullon-sensitive icons to be placed on the screen, A demonstration 

program and set of icons is included. 


PIPE DREAM 3 DEMO 

A full demonstration of the new Riscware PipeDream 3 
reviewed in this issue. 


MASTERING THE WIMP (2) 

The example program from this series which aims to 
introduce Wimp programming. 


INTO THE ARC 

A RISC OS application to illustrate the use of sprites. 


AN EXTENDED SPRITE INTO UTILITY 

The source code for a utility to list details on sprites, whether 
they be in the system, user, or Wimp areas. 


INDIRECTION OPERATORS EXPLAINED 

A short program showing how the Sasic indirect bn operators 
can be used to directly manipulate memory. 


ACORN SFORMED 

A program to edit WIMP templates, simplifying the process of 
creating complex windows and dialogue boxes. Brief 
instructions are provided on the disc, and a future issue will 
include more comprehensive details 


HH fril filr Beffll ?[jrl rtwn* “1th Piprtrf*. Imi cjn vTIiU 
thrwgb the dtnuteflt In usr>} Uv is arid dor mw keys, u» Hage w 
Irid Fjgt Dowi V«ij3 <x clicking in lh» scrcll tw on the r igh*. IWrt 
ride oF the “indon, 


RISC User magazine discs art available lo order, or by subscription. Full details ol prices elc, ere given on the back cover of each Issue of RISC User, 
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RISC USER magazine 



RISC User is available only on subscription at the rates shown below. Full subscribers to RISC User may also take out 
a reduced rale subscription to BEEBUG (the magazine for the BBC micro and Master series). 


M subscriptions, including 
overseas, should be in 

RISC USER SUBSCRIPTION RATES 

RISC USER 

pounds sterling. We will 



& BEEBUG 

also accept payment by 

£14.50 

1 year (10 Issues) UK, 9FPO, Ch.l 

£23.00 

Connect, Access and 

£20.00 

Rest of Europe 8c Eire 

£33.00 

Visa, and official UK 

£25.00 

Middle East 

£40.00 

orders are welcome. 

£27.00 

Americas 8c Africa 

£44.00 

BACK ISSUES 

£29.00 

Elsewhere 

£46.00 


m 


We intend to maintain stocks of back issues New subscribers can therefore obtain earlier copies to provide a 
complete set from Vot. 1 issue t Back issues cost £1.20 each. You should also include postage as shown: 


Destination 

first Issue 

Each subsequent Issue 


UK, BFPO, ChJ* Europe plus Eire Elsewhere 

60p £1 £2 

3Cp 50p £? 



MAGAZINE DISC 



The programs from each issue of RISC User am available on a monthly 3.5'disc This win be available to order, or 
you may take out a subscription to ensure that the disc arrives at tie same time as the magazine The disc for 
Volume f Issue 1 (with six programs and animated graphics demo) is at the special tow price of £375. The disc for 
each subsequent issue contains a# the programs from the magazine, together with a number of additional items by 
way of demonstration, all at he standard rate of £4.75. 


MAGAZINE DISC PRICES UK Overseas 

Single Issue discs £ 475 £ 475 

Six months subscription £25,50 £30,00 

Twelve months subscription £50.00 £56.00 


Disc subscr^hm indude postage, but 
you should add 60p per disc for 
wSividuN orders (3Qp farads 
discs on the same order). 

AH orders, subscriptions and other 
correspondence should be 
addressed to; 


RISC User, 117 Hatfield Road, St Alban*, Herts All 4JS. 
Telephone: St Albans (0727) 40303 

(24hrs arwwwphone serrice for payment by Connect, Access or Visa card) 










